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NOTICE 



The specifications of the software system described in this publication are subject to change without notice. The availability or performance of some features may 
depend on a specific configuration of equipment such as additional tape units or larger memory. Customers should consult their XDS sales representative for details. 
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DEFINITION OF TERMS 



active foreground program: a foreground program is active 
if it is resident in memory, connected to interrupts, or 

in thp nrnrpw nf hpinn fsnfprvsri into t!~.s c-./ctem \t\a a 

!RUN control command. 

background area: that area of core storage allocated to 
batch processing. This area may be checkpointed for 
use by foreground programs. 

background program: any program executed under Monitor 
control in the background area with no external inter- 
rupts active. These programs are entered through the 
batch processing input stream. 

binary input: input from the device to which the BI (binary 
input) operational label is assigned. 

centrally connected interrupt: an interrupt that is con- 
nected to a Monitor interrupt routine which first 
saves the environment of the system and then switches 
the environment to that of the task that gets control 
when the interrupt occurs. 

checkpointed job: a partially processed background job 
that has been saved in secondary storage along with 
all registers and other "environment" so that the job 
can be restarted. 

control command: any control message other than a key-in. 
A control command may be input via any device to 
which the system command input function has been 
assigned (normally a card reader). 

control message: any message received by the Monitor that 
is either a control command or a control key-in (see 
"key-in"). 

Data Control Block (DCB): a table in the executing pro- 
gram mat contains toe i mormon on usea Dy the Monitor 
in the performance of an I/O operation. 



foreground task: a body of procedural code that is associ- 
ated with (connected to) a particular interrupt and that 



dedicated memory: core memory locations reserved by the 
Monitor for special purposes, such as traps, interrupts, 
and real-time programs. 

directly connected interrupt: an interrupt which, when it 
occurs, causes control to go directly to the task. E.g. , 
execution of the XPSD instruction in the interrupt lo- 
cation gives control to the task rather than first going 
to a Monitor interrupt routine. 

end record: the last record to be loaded, in an object mod- 
ule or load module. 

execution location: a value replacing the origin of a relo- 
catable program, to change the address at which program 
loading is to begin. 

foreground area: that portion of memory dedicated specifi- 
cally for foreground programs. 

foreground program: a load module that contains one or 
more foreground tasks. 
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Function Parameter Table (FPT): a table through which a 
user's program communicates with a Monitor function 
(such as an I/O function). 

GO file: a temporary disc file of relocatable object mod- 
ules formed by a processor. 

idle state: the state of the Monitor when it is first loaded 
into core memory or after encountering a !FIN control 
command. The idle state is ended by means of a C 
key-in. 

installation control command: any control command used 
during System Generation to direct the formatting of 
a Monitor system. 

key-in: information entered by the operator via a keyboard. 

keyword: a word, consisting of from 1 to 8 characters, 
that identifies a particular operand used in a con- 
trol command. 

library input: input from the device to which the LI (library 
input) operational label is assigned. 

load map: a listing of significant information pertaining to 
the storage locations used by a program. 

load module: an executable program formed by using relo- 
catable object modules and/or library object modules 
as source information. 

logical device: a peripheral device that is represented in a 
program by an operational iabel (e.g. , BI or BO) rather 
than by a specific physical device name. 

Monitor: a program that supervises the processing, loading, 
and execution of other programs. 

object deck: a card deck comprising one or more object 
modules and control commands. 

object language: the standard binary language in which the 
output of a compiler or assembler is expressed. 

object module: the series of records containing the load 
information pertaining to a single program or sub- 
program. Object modules serve as input to the Over- 
lay Loader. 

operational label: a symbolic name used to identify a logi- 
cal system device. 

option: an elective operand in a control command or pro- 
cedure call, or an elective parameter in a Function 
Parameter Table. 

Overlay Loader: a processor that loads and links elements 
of overlay programs. 

overlay program: a segmented program in which the segment 
currently being executed may overlay the core storage 
area occupied by a previously executed segment. 



physical device: a peripheral device that is referred to by 
a "name" specifying the device type, I/O channel, 
and device number (also see "logical device"). 

postmortem dump: a listing of the contents of a specified 
area of core memory, usually following the abortive 
execution of a program. 

Relocatable Object Module: a program, or subprogram, 
generated by a processor such as Macro-Symbol, 
FORTRAN, etc. (in XDS Sigma 5/7 object language). 

resident program: a program loaded into core each time the 
system is booted in. 

ROM: Relocatable Object Module. 

secondary storage: any rapid-access storage medium other 
than core memory (e.g. , RAD). 

segment loader: a Monitor routine that loads overlay seg- 
ments from disc storage at execution time. 

source deck: a card deck comprising a complete program 
or subprogram, in symbolic EBCDIC format. 



source language: a language used to prepare a source pro- 
gram (and therefrom a source deck) suitable for process- 
ing by an assembler or compiler. 

standard control section: a control section whose length is 
not known by a 1-pass processor until all the load in- 
formation for that section has been generated. 

symbolic input: input from the device to which the SI 
(symbolic input) operational label is assigned. 

symbolic name: an identifier that is associated with some 
particular source program statement or item so that 
symbolic references may be made to it even though its 
value may be subject to redefinition. 

system library: a group of standard routines in object- 
language format, any of which may be included in a 
program being created. 

Task Control Block (TCB): a table of program control informa- 
tion built by the relocating loader when a load module 
is formed. The TCB is part of the load module and con- 
tains a temp stack and the data required to allow re- 
entry of library routines during program execution. 
The TCB is program associated and not task associated. 



1. INTRODUCTION 



The XDS Sigma 5/7 Real-Time Batch Monitor (RBM) is the 
major control element of the operating system described in 
this manual. The total operating system includes the Moni- 
tor, Overlay Loader, RAD Editor, language processors, and 
user real-time and batch programs. 

The content of this manual is operator-oriented in that it is 
specifically directed toward Monitor/operator communica- 
tions, procedures, control command formats, and device 
considerations necessary to maintain the system and process 
oroaram inoufs under Monitor control. A comprehensive 
discussion of the internal functions of the Monitor and its 
associated components is given in the XDS Sigma 5/7 Real- 
Time Batch Monitor Reference Manual (Publication No. 
90 15 81). 

The RBM system divides core memory and Rapid Access Data 
file (RAD) utilization into two distinct nrens: foreground 
(privileged) areas and background areas. The purpose of 
this division is to guarantee real-time tasks adequate mem- 
ory and protection in the execution of highly critical pro- 
cesses, and at the same time, offer an efficient method for 
using up idle CPU time when real-time processes are not 
busy. Allocation of both areas is performed at System 
Generation time (SYSGEN) in accordance with the needs 
of the local installation. 

Typically, the operator's responsibilities are directed to- 
ward two distinct applications of program execution: real- 
time processing and batch (background) processing. 



REAL-TIME PROGRAMS 

Real-time programs are connected to hardware interrupts 
that receive signals from external sources or real-time clocks 
to trigger execution and respond to these external events 
within microseconds. 

Some real-time programs are loaded and initialized at Sys- 
tem Boot time. Others can be run and released by the oper- 
ator. The first method is used when the reai-time process 
normally remains unchanged and is constantly operative. 
Typical examples would be a satellite tracking system or 
the control element of an automated plant or factory. The 
second approach is sometimes used when real-time opera- 
tions are executed periodically or irregularly. An example 
would be a test procedure in an experimental laboratory. 
In this case, the operator must access the protected portion 
of memory through an FG key-in to load and initialize the 
program (see Table 2 for key-in descriptions). 



system is designed to allow background programs to use up 
all available CPU time when the real time processes are not 
operative, thus giving greater economy to the system. 

In contrast to real-time tasks whose priority sequence and 
function is controlled by external hardware interrupt or op- 
erator key-in, background programs are executed in a serial 
fashion and their sequence is controlled by control commands 
inserted in the job stack. 
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BACKGROUND PROGRAMS 



Background jobs are assembled or compiled and executed in 
the background area of core memory. The RBM operating 



Background compilations or as 
from some peripheral device (generally a card reader) onto 
a file in the Background Programs area of the RAD and exe- 
cuted in background core storage in serial fashion. 



SOFTWARE ENVIRONMENT 

The software modules and files with which the operator will 
find himself directly or indirectly involved are 

Monitor 

Job Control Processor 

Overlay Loader 

OV file 

permanent RAD Files 

RAD Editor 

System Processors 

GO File 

User Programs (foreground and background) 



MONITOR 

The Monitor is the primary control element of the operating 
system and functions as a supervisor that coordinates and 
controls a continuous series of foreground and background 
jobs. It is also the two-way communications link between 
the operator and the total system. The operator can direct 
the system to change the status of an I/O device and alter 
system operation. The Monitor communicates with the op- 
erator via the operator's console (OC device) and in some 
instances, the listing log (LL device, which is generally a 
line printer) with error messages, status messages, or requests 
for operator action such as readying a magnetic tape unit. 

Other services the Monitor performs includes preserving the 
relative priority of real-time tasks, protecting the foreground 
core and secondary storage from background interference, 
monitoring available CPU time for background use when real- 
time interrupts are idle, and providing general I/O services 
for all tasks. 



Introduction 



Parts of the Monitor are permanently resident in core storage 
so that it can respond immediately to a request for service 
from a real-time task. Response time to such tasks is highly 
critical and is measured in microseconds. Less critical por- 
tions of the Monitor such as the Job Control Processor are 
permanently stored on the Systems area of the RAD and 
brought into core as needed. 



JOB CONTROL PROCESSOR 

The Job Control Processor (JCP) reads and processes control 
commands input from the Control Command (C) input device. 
Whenever the JCP encounters a request in the job stack to 
execute a processor (such as the FORTRAN compiler), or a 
user program, it causes the processor or program to be loaded 
into core from the RAD and the Monitor to relinquish control. 

The JCP outputs error and status messages to the operator on 
both the LL and OC devices (unless both are assigned to the 
same device) in contrast to other Monitor messages that are 
output only on the OC device. The only significance the 
JCP has to the operator is that at least one standard status 
message to the operator refers to the JCP; he may also wonder 
why some messages are output only on OC and others are 
output on both OC and LL. Generally, messages output on 
LL are for programmer reference. All messages of interest 
to the operator are output on the OC device. 



OVERLAY LOADER 



The Overlay Loader creates programs in overlay (segmented) 
form. That is, the Loader converts a program in object 
module form into an absolute core image version called a 
load module that is segmented for later execution. Segment- 
ing permits programmers to create programs much larger than 
the available core size. 

Like any other processor, the Loader is called in for execu- 
tion by a control command in the user's job. The mnemonics 
for the control commands used by the Overlay Loader are 
similar to those used by the Monitor but the format of the 
commands is slightly different (see the Overlay Loader chap- 
ter later in this manual). When the Loader has control, it 
communicates with the operator through its own status and 
error messages. 



RAD FILES 

Since the entire RBM system is RAD oriented, every job run 
by the operator will directly or indirectly involve the use, 
modification, allocation, or release of permanent RAD files. 
The files of greatest interest to the operator and the mne- 
monics used to reference them on control commands are as 
fo! lows: 

• Foreground Programs area (FP) contains a collection of 
foreground programs and optional User Libraries and 
Public Libraries. Referenced library routines are 



included in the user load modules at "Load" time. 
Public Libraries are a group of routines shared by a 
number of programs and are called into core for exe- 
cution only when referenced. 

System Programs area (SP) contains the Monitor and the 
set of language processors used by the local installation, 
such as Macro-Symbol and FORTRAN IV-H. The area 
also contains the System Library (i.e., FORTRAN IV-H 
Library/Run-time), RAD Editor, and Overlay Loader. 
All translators are called by user jobs to execute in the 
background core space. 

Background Programs area (BP) contains the set of user 
operational programs that execute in the background 
and a background User Library if desired. 

Data areas (Dl through DF) are divided into foreground 
and background data areas, and are used for storing 
data. Foreground programs cannot write into files in 
background data areas or vice versa; however, either 
type of program can freely read from both areas. 

Background Temp area (BT) contains temporary (scratch) 
files (XI through Xn where n is a SYSGEN parameter) 
used by background programs for intermediate storage 
in processing. Their use is identical to scratch tapes 
on magnetic tape units, and files can be rewound or 
searched. Note that temp files are erased at the end 
of each job step by having their pointers reset, unless 
a SAVE command is present within a job step. Temp 
files are automatically reset when a new JOB command 
is encountered in a job stack regardless of SAVE com- 
mands, and there is no way to save data on temp files 
from one job to another. 

The GO and OV files are also in the BT area and are 
special cases. The GO file contains Relocatable 
Object Modules (ROMs) formed by a processor if the 
GO option is specified. The OV file contains the exe- 
cutable program formed by the Overlay Loader if a pro- 
gram file name was not specified at load time. 



RAD EDITOR 

The RAD Editor controls RAD allocation for areas containing 
permanent RAD files and performs utility functions for all 
areas. 

The operator will encounter a number of jobs involving RAD 
file manipulation via the RAD Editor, including: allotting 
RAD files, building RAD files, dumping RAD areas or files 
on user request, copying object modules from libraries, 
loading new programs into user or system libraries, inhibit- 
ing bad RAD tracks, etc. 



RAD file manipulation via the RAD Editor is governed 
by control commands that have a format similar to Moni- 
tor control commands. When the RAD Editor has con- 
trol, it communicates with the operator through its own 
error and status messages. 



Software Environment 



SYSTEM PROCESSORS Symbol 

Macro-Symbol 
The following language processors are available under RBM, 

and any or all of them may be incorporated in the local The selected processors are permanently stored in the Sys- 

system: tern Programs area on the RAD and called into core storage 

to assemble or compile a user's source program through a 
FORTRAN IV-H control command in a user's source deck. The Monitor re- 

linquishes control to the requested processor until the job 
SL-1 step is completed. 



Software Environment 



2. OPERATOR/SYSTEM INTERFACE 



Communication between the operator and the system takes 
place through operator key-ins (solicited or unsolicited), 
and Monitor printouts. In addition to job status messages, 
Monitor type-outs on the keyboard/printer inform the oper- 
ator of various abnormal or error conditions affecting system 
operation. All Monitor messages to the operator are pre- 
ceded by two exclamation marks (! !). 



UNSOLICITED KEY-INS 

Unsolicited key-ins provide the operator with a means of 
controlling a background job, or the loading or releasing of 
foreground programs. Any control the operator can exercise 
over the foreground is provided through key-ins, so that 
foreground control is independent of the background job 
stack. 

Depressing the INTERRUPT switch on the Control Panel ini- 
tiates a key-in. * The types of key-ins available are listed 
in Table 2. When all foreground tasks are inactive, the 
Monitor responds with the message 

! ! KEY-IN 

on the operator's console. The operator then keys in the 
symbol and data he wishes to transmit to the system. Two 
conventions apply to all key-ins: 

1. End each message by depressing the NL (New Line) 
key. 

2. Delete a message by depressing the EOM (End of 
Message) key before depressing the NL key. 

Use of an exclamation mark to precede an operator key-in 
is optional. Spaces (blanks) to separate fields can be used 
as desired. 



DEVICE NAMES 

Some key-ins require a device name. Devices are identi- 
fied by type, channel, and device number. Device types 
and their associated symbols are listed in Table 1. The 
eight available channels are represented by a single letter, 
from A to H. Device numbers are given in two-digit hexa- 
decimal code, from 00 to 7F. Alternatively, device con- 
trollers and their associated devices may be identified by a 
single hexadecimal digit from 8 to F for the device con- 
trollers, followed by a single hexadecimal digit from 
through F for the associated device. 



Examples: 
CRA03 



Card reader, Channel A, device 3 



7TAE 1 7-track magnetic tape, Channel A, device 

controller E, device 1. 

Table 1. I/O Device Type Codes 



Mnemonic 


Device Type 


TY 


Typewriter 


LP 


Line Printer 


CR 


Card Reader 


CP 


Card Punch 


9T 


9-track magnetic tape 


7T 


7-track magnetic tape 


PP 


Paper tape punch 


PR 


Paper tape reader 


DC 


Magnetic disc or XDS RAD 


NO 


Not a standard device. Used as a 




special purpose device for direct I/O 




execution (IOEX). 


PL 


Plotter 



OPERATIONAL LABELS 

An operational label identifies a logical device type so that 
it can be assigned to a specific I/O device. For example, 
the operational label BI stands for binary input. This type 
of data is usually assigned to a card or tape reader. Oper- 
ational labels are assigned at system generation time but 
may be changed by a STDLB (for standard label) key-in. At 
the beginning of each job, the operational labels are re- 
assigned to their initial assignment. System operational 
labels are listed below. 

Label Meaning 

BI Binary input 

CI Compressed input (Macro-Symbol) 

SI Source input (symbolic) 

C Control command input 

BO Binary output 



If the foreground is busy when a key-in is initiated, the 
Monitor will not respond until all foreground interrupts 
are satisifed. 



Both the temporary and permanent assignments of this 
label can be changed through STDLB key-in or control 
command unless "C" is assigned to zero. In this event, 
STDLB will only change the temporary label. 



Operator/System Interface 



Lab< 



Meaning 



STANDARD KEY-INS 



DO 
LO 
CO 
LL 



Diagnostic output 



Listing output 



Compressed output (Macro-Symbol) 

Listing log (control commands and other 
system messages) 



The analysis and subsequent action from an unsolicited key- 
in is performed at the RBM Control Task priority level. 
When the RBM Control Task becomes the highest priority in 
the system (that is, when all foreground tasks are inactive) 
the message 

MKEY-IN 

will be output on the OC device to inform the operator that 
the system can now accept a key-in. 



OC 
SO 
PL 



Operator's console data 



Symbolic output (SL-1) 



Plotter output 



Note that if the typewriter is busy at the time of the Con- 
trol Panel Interrupt (i.e., waiting for an input to complete), 
the operator must complete the input before the ! ! KEY-IN 
type-out can occur. All legal key-ins are itemized in 
Table 2. 



Table 2. Operator Key-Ins 



Key-In 


Purpose 


X 


Abort current background job. Message on OC and LL will show last 
location executed. 


C 


Continue processing in the background. If the background was in a wait 
or idle state, the system leaves that state and proceeds. 


COC 


Job was halted because of error in control command. Continue from OC 
with correct control command (after depressing the Control Panel 
interrupt key). 


DT mo,day,yr,hr,min 


Input of current date and time. Example: DT 8, 17,69,22, 30 


Rl IN nnme* 


Load and execute a foreground program, ine name oi tne icreground iiie 
to be loaded must be input. 


TY 


Transfer control from the C device to OC (typewriter). 


SY 


Override RAD software protection to allow a background program to write 
in any RAD file. The SY key-in is cleared when the next !JOB com- 
mand is encountered. 


FG 


Permit loading of foreground program from background job stack for exe- 
cution via a !RUN control command. 


CC 


Retransfer control back to the C device from OC. 


RLS name 


Release foreground program designated in the (file) name. 


STDLB label [,area] , name 


Change permanent operational label assignment. The "label" identifies 
the op label. The "area" specifies a RADarea if the newoplb isassigned toa 
RAD file; the "name" specifies a physical device or file to which the oplb 
is to be assigned. The new assignment stays in effect until the system is 
rebooted or the assignment changed by another key-in. 


INTLB label, location (hex) of interrupt 


Change assignment of interrupt labels. 



Operational Labels 5 



Table 2. Operator Key-Ins (cont. ) 



Key-In 


Purpose 


_.. IT [locationl 
CINT (label t ' 


D 
A 
T 




Disarm, arm and enable, or trigger specified interrupt. The "location" 
specifies the hex address of the interrupt; "label" specifies an interrupt 
label; "D" is used to disarm specified interrupt; "A" is used to arm and 
enable; "T" is used to arm, enable, and trigger the interrupt. 


FMEM [n] 


Change foreground core memory allocation. The "n" specifies number of 
pages to be allocated to the foreground. Reallocation takes place after 
current background job step is completed. If the foreground is not free, 
the alarm ! !FGD AREA ACTIVE is output. If "n" is not specified, the fore- 
ground is reset to the allocation specified at SYSGEN. 




DM 

DF 

DB 


[from,to] 


Dump Monitor (DM), Dump Foreground (DF), or Dump Background (DB) 
areas of memory. If "from, to" is absent, the entire currently defined 
area will be dumped; if present, the first word address in hex and last word 
address in hex of the selected area are defined. 


DED yyndd {^[,1] 


Dedicate a device, and its controller and, optionally, all other devices on 
the same IOP to the foreground or to IOEX. The "yyndd" is the name of 
the device to be dedicated; the "F" specifies dedication to foreground; "X" 
specifies dedication to IOEX; "I" specifies all devices on IOPn are to be 
dedicated. 


UND yyndd j^} [,I] 


Undedicate a device or IOP previously dedicated through DED. All param- 
eters present in the DED previously used must be present in the UND key-in. 



COMBINED KEY-INS 

To expedite operator key-ins, the following combinations 
of key-ins are recognized: 



Combined Form 

FGC 

SYC 

SFC, FSC 

TYC 



Result 

Executes FG and C key-ins. 

Executes SY and C key-ins. 

Executes FG,SY, and C 
key-ins. 

Executes TY and C key-ins. 



CORRECTING A KEY-IN 



If an operator key-in is not recognized by the system as 
valid input, the message 

!! KEY ERR 

is output on OC. The operator should retype the correct 
key-in. 



is output on the OC device. Such a message is of the 
form 

! ! name message 



name is the physical device name (see ASSIGN 

control command). 

message is the message string informing the oper- 

ator of the specific condition that has been de- 
tected; for example: 

ERROR (error was detected on operation) 



MANUAL (device not ready) 

Monitor I/O messages are discussed below, grouped ac- 
cording to the type of device to which they apply. 

After correcting the abnormal conditions, the operator re- 
sponds by means of a key-in. The format for an I/O 
key-in is 

name a 
where 



UtViLt CUN I KUL 



If the Monitor encounters an abnormal condition during 
an I/O operation, a pertinent message to the operator 



name is the physical device name of the device 

involved in the I/O operation. 

a specifies a Monitor-action character (see 

Table 3). 



Operational Labels 



Table 3. Monitor Actions 



a 


Monitor Action 


C 

E 

R 


Continue "as is". 

Inform the user program of the error and 
transmit record "as is". 

Repeat the I/O operation. 



CARD READER 

If the card reader fails to read properly, or if a validity 
error occurs, the Monitor outputs the message 

! ! CRndd ERROR 



on the OC device. The above message indicates that the 
card punch is not functioning properly, and the operator 
should reevaluate the job stack based on this knowledge. 
Improperly punched cards are routed to an alternate stacker. 

If the input hopper is empty, the stacker is full, chip box 
is fuN, or device is in manual mode, the Monitor outputs 
the message 

N CPndd MANUAL 

on the OC device. The operator corrects the condition and 
presses the START button on the card punch. 

If a power failure or a feed check error occurs, the Monitor 
outputs the message 

! ! CPndd ERROR 



on the OC device. After correcting the condition, the oper- 
ator respondswith an I/O key-in message. The action char- 
acter selected (see Table 3) depends on the circumstances. 

If a feed check error or a power failure occurs, the Monitor 
outputs the message 

! ! CRndd ERROR 



! ! CRndd TIMED OUT 

on the OC device, depending on where in the cycle the 
error took place. If the card in the hopper is damaged, the 
operator replaces if with a duplicate; then, in either case 
he presses the RESET and START buttons on the card reader, 
and responds to the Monitor with the key-in 

CRndd R 



If thp rnrrl stnrkpr i<; full thi= hr>r\r\e 



IC omr^f\/ r\r tho Aa — 



vice is in the manual mode, the Monitoroutputs the message 

! ! CRndd MANUAL 

on the OC device. The operator corrects the condition and 
then presses the START button on the card reader. 

CARD PUNCH 

Instead of outputting an error message when a punch error 
is detected, the I/O handler attempts to punch a card x 
times (x = NRT, a DCB parameter specified by the user) 
before outputting the message. 

! ! CPndd ERROR 



!! CPndd TIMED OUT 1 " 

on the OC device, depending on where in the cycle the 
error took place. If the card in the hopper is damaged, the 
operator removes it; then, in either case, he presses the 
RESET and START buttons on the card punch and responds to 
the Monitor with the key-in 



CPndd R 



PRINTER 



When an irrecoverable print error is detected, the Monitor 
outputs the message 

! ! LPndd ERROR 

on the OC device. The I/O handler attempts to print a 
line x times (x = NRT, a DCB variable specified by the 

1/ ^^ \_» J%~ \ l U^/IVI^ UUIUUI < iiiu II l& UUVV& II IC»UUC • I I IC yuci 

ator's response after correcting the condition depends on 
the specific device and circumstances. 

If the printer is out of paper, the carriage is inoperative, or 
the device is in the manual mode, the Monitor outputs the 
message 

! ! LPndd MANUAL 

on the OC device. The operator corrects the condition and 
presses the START button on the line printer. 

If the line printer power is off, the Monitor outputs the 
message 

!! LPndd UNRECOG 



This message also occurs if CRndd does not respond to SIO 
within 5 seconds. 

For a comprehensive discussion of this parameter, see 
Chapter 4, DCB Creation, in the Sigma 5/7 Real-Time Batch 
Monitor Reference Manual. 



This message also occurs if CPndd does not respond to SIO 
within 5 seconds. 
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on the OC device. The operator should correct the con- 
dition and respond with the key-in 



LPndd R 



PAPER TAPE READER 



If an error occurs during the reading of paper tape, the 
Monitor outputs the message 

! ! PRndd ERROR 

on the OC device. After correcting the condition, the oper- 
ator responds with an I/O key-in message. The action char- 
acter selected (see Table 3) depends on the circumstances. 

PAPER TAPE PUNCH 

If the paper tape punch is out of paper, the Monitor outputs 
the message 

! ! PPndd MANUAL 

on the OC device. The operator corrects the condition and 
depresses the START key. 

If the paper tape punch is off-line or the power is off, the 
Monitor outputs the message 

!! PPndd UNRECOG 

on the OC device. The operator corrects the condition and 
responds to the Monitor with the key-in 

PPndd C or R 



MAGNETIC TAPE 

If an error occurs during the reading or writing of magnetic 
tape, the Monitor I/O handler attempts a recovery x times 
(x = NRT, a DCB variable). If the error is irrecoverable, 
the user is informed via an error return. 

If a magnetic tape is addressed and there is no physical reel 
or power, the Monitor will output the message 

! ! MTndd UNRECOG 

on the OC device. The operator's response depends on the 
circumstances. 

ERROR AND STATUS MESSAGES 

When events take place in the system requiring operator 
intervention, or when one job completes and another job 
begins, RBM informs the operator of these conditions by 
messages output to the operator's console (OC device). 
All such messages from the Monitor begin with two excla- 
mation marks (! !). Generally, these messages require no 
operator response on the typewriter, but may indicate that 
some peripheral needs attention. 

MONITOR MESSAGES 

The messages itemized in Table 4 are output by the Monitor 
on the OC device. 



Table 4. Monitor Messages 



Message 


Meaning 


!! KEY ERROR 


Monitor cannot recognize an unsolicited key-in response. A new key-in should be 
attempted. 


UJOB ABORTED at yyyyy 


Background job has been aborted. The "yyyyy" parameter contains the hexadecimal 
address of the last instruction executed in the background. If aborted because the 
specified limit on a ! LIMIT control command has been reached, yyyyy will contain 
the word " LIMIT" . 


! ! PAUSE comments 


A ! PAUSE control command card has been read. The comments field may contain tape 
mounting instructions. A key-in of "C" after pressing the INTERRUPT switch will cause 
RBM to continue reading from the job stack. 


!! BEGIN WAIT 


Background has executed a "WAIT" request; an unsolicited key-in of "C" will continue 
background processing. 


MBCKGCKP 


Background has been checkpointed as a result of a foreground program load. 


!!BKG RESTART 


Background has been restarted from its point of interruption. 


! ! yyndd WRT PROT 


Indicated unit is write-protected. If a magnetic tape, insert the write ring and place 
tape in "start" condition to continue if the program is waiting for operator action; or 
abort background program if the background is performing an invalid operation. 


llyyndd UNRECOG 


Some condition on device type yy with physical device number ndd (hexadecimal) has 
caused device to become not operational. 
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Table 4. Monitor Messages (cont. ) 



Message 


Meaning 


Myyndd ERROR 


A parity or transmission error has occurred on this device. Any automatic retries that 
u/pre soecified have been nerformed nefore thi^ mp^^nnf \A/n<; oiitntst. 


Hyyndd MANUAL 


Device specified is in manual mode and may be out of paper, cards, or tape. 


URLS NAME NA 


A key-in request has been made to release a foreground program, but the name of the 
program is not included among the active foreground programs. 


M.FILE NAME ERR 


A problem has occurred from a STDLB key-in request in attempting to open or close a RAD fi le. 


1 ir^r\ AnrA a/~tt\/i- 


An FMEM key-in request cannot be honored because a foreground program is stiii active 
in the area being released. 


!!NOT ENUF BCKG SPACE 


Insufficient background space to load the requested background program. 


!! UNABLE TO DO ASSIGN 


An ! ASSIGN command cannot be fulfilled because either the DCB cannot be found 
or the DCB is only five words in length, and a seven-word DCB is required (seven- 
word DCBs are required for any RAD file assigns). 


UBKG IN USE BYFGD 


Background space is being used by the foreground, but a checkpoint was not required 
since the background was inactive at the time of the foreground load. 


!!CK AREA TOO SMALL 


An attempt was made to checkpoint the background, but not enough space was avail- 
able on the CK area of the RAD. The background space will nevertheless be released 
to the foreground, and the active background job will be aborted when the background 
is restarted. 


!!l/0 ERROR ON CKPT 


An attempt was made to checkpoint the background, but a RAD I/O error occurred 
during the process. The background space will nevertheless be released to the fore- 
ground, and the active background job will be aborted when the background is restarted. 


!! LOADED PROGxxxxxxxx 


The specified foreground programs have been loaded for execution by the foreground 
loader. A maximum of three program names will be output in the one message. 


!! UNABLE TO CLOSE 
DCB xxxxxxxx 


The specified DCB was not closed upon releasing a foreground program. 


! ! PROG xxxxxxxx RELEASED 


The specified foreground program has been released. 


!!FGT FULL, CAN'T 
LOAD xxxxxxxx 


The specified foreground program cannot be loaded for execution because no room 
exists in the Foreground Programs Table. 


! SCORE USED, CAN'T 
LOAD xxxxxxxx 


The specified foreground program cannot be loaded for execution because the core 
space required for its execution is already in use. 


!!I/0 ERR, CAN'T 
LOAD xxxxxxxx 


An I/O error occurred in attempting to load the specified foreground program for 
execution. 


MNONEXIST. , CAN'T 
LOAD xxxxxxxx 


The specified foreground program cannot be loaded for execution because it does not 
exist on the RAD or a Public Library required by the program does not exist on RAD. 
The foreground program must exist in the FP area or the OV file. 


UPUB LIB, CAN'T 
LOAD 


The request to load the specified Public Library for execution is not valid, since all 
Public Libraries must be automatically loaded by the system, as needed. 


!! UNABLE TO LOAD BCKG 
PUB LIB 


The current attempt to execute a background program has failed, because the Public 
Libraries required by the background program could not be loaded. The current back- 
ground job is aborted. 
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Table 4. Monitor Messages (conf. ) 



Message 


Meaning 


!!CKPT WAITING FOR 
BCKG I/O RUNDOWN 


The checkpoint function is waiting for all background I/O to run down so that the 
checkpoint of background can be completed. 


UUNABLE TO TRIGGER 
CONTROL TASK INT. 


This alarm is output to OC after the system is booted from the RAD if the RBM Control 
Task Interrupt cannot be triggered. 


SIGMA 5/7 RBM-2, 
VERSION xxxx 


This message is output on the OC device every time the system is booted from the RAD. 
The message can be terminated prematurely by hitting the BREAK key on the typewriter. 



TRAP HANDLER MESSAGES 

The following messages are output by the trap handler upon 
occurrence of the various traps if the user does not specify 
his own trap handling: 



!MEM. PROT. ERR AT xxxxx 
IPRIVILEGE INST. AT xxxxx 
INONEXIST. ADD. AT xxxxx 
INONEXIST. INST. AT xxxxx 
IUNIMPLE. INST. AT xxxxx 
! STACK OVERFLOW AT xxxxx 
1ARITH. FAULT AT xxxxx 
1WDOG TIMER RUNOUT AT xxxxx 
• ILL. PARAM., CAL AT xxxxx 



Note that the message "ARITH. FAULT AT xxxxx" is output 
for the fixed point arithmetic overflow trap, the floating- 
point fault trap, and the decimal arithmetic fault trap. The 
message 

" ! "ILL. PARAM. , CAL AT xxxxx" 

is output if a user program furnishes the Monitor an invalid 
parameter while attempting to use a Monitor function. 



JCP MESSAGES 

In general, the messages itemized in Table 5 are output by 
the Job Control Processor on both the OC and LL devices. 
The JCP reads and processes each control command until it 
encounters a request to execute a processor or user program 
at which time the appropriate program is read into the back- 
ground and given control. JCP status or error messages deal 
with control commands or other program input diagnostics. 



Table 5. JCP Messages 



Message 


Meaning 


!!JCP 


The JCP has just begun to read control commands. This occurs both at the beginning of 
a job and between steps within a job. If C is assigned to the typewriter or if "TY" 
override is in effect, the input light on the typewriter will indicate that RBM is ready 
for input of a control command. This message is output only to OC. 


UCC ERROR IN ITEM xx 


An error exists in a JCP control command in the indicated item. Every item except 
the ! character followed by a blank or comma is counted in determining the item in 
error. If the first character is not an exclamation character, the message will desig- 
nate ITEMO. 


!!SCHING FOR JOBCMD 


The present job has been aborted and the JCP is searching the job stack for the next 
JOB or FIN command. 


!!CC ERROR, FG KY-IN 
REQUIRED 


A request has been made to run a foreground program from the background job stack 
without previously inputting an FG key-in. The RUN or ROV command must be 
reentered after the FG key-in is input. 


!!CC ERROR, BT OVERFLOW 


The file size input on an 1ALLOBT command is greater than the available Background 
t d A r> 


MFGT FULL, CAN'T LOAD 
xxxxxxxx 


The indicated foreground program cannot be loaded because insufficient space exists 
in the Foreground Program Table. 
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Table 5. JCP Messages (cont. ) 



Message 


Meaning 


1 ! FILE xxxxxxxx NONEXIST. 


The indicated RAD file was never allocated via the RAD Editor or was never 
written into. 


NPUB LIB, CAN'T 
LOAD xxxxxxxx 


The designated program on the RUN command is a Public Library and cannot be exe- 
cuted via a RUN command. 


!!CC ERROR, ILL 
REALLOCATION OF BT 


An improper ALLOBT command was input to change a Background Temp (BT) scratch 
file that was designated as a "saved" file prior to this job step. 


!!BT OVERFLOW 


Insufficient Background Temp RAD space to execute the requested background pro- 

^■Ulll. IMC WU 13 UUUI ICU. 


!!BI CKSM ERR 
!!BI SEQ ERR 


JCP loader encountered a checksum or sequence error on a binary card during the 
loading process. 


!!ERR, CONTROL BYTE = xx 


JCP loader is not equipped to process the indicated control byte. 


! !TOO MANY DEF/REF's 


ITP \rsnAar Uric * n ^^,,nl- a r rl nnro 4-U~~ 9 ^ ^ J^-l <-T r T „ *.l U T « ~ 4- l..l„ 1 t - _ 

loaded. 


!! UNSATISFIED REF xxxxxxxx 


Indicated REF was not satisfied during the loading process, This alarm occurs only 
on LL if no map was requested, or on LO if a MAP was requested. 


!!NOT ENUF SPACE FOR 
LOAD 


JCP loader is unable to complete the load because of insufficient background space. 


MTOO MANY DCB's 


The maximum number of M: and F: DCBs was exceeded during the loading process. 
Approximately 27 DCBs can be accommodated by the system. The excess DCBs will 
not be stored in the DCB table or the RAD header file. 


! 1ILLEGAL BINARY CARD 


An EBCDIC card was read by the JCP loader where a binary card was expected. 


i iUNSATISFIED REF's 
DURING LOAD 


This message is typed to the operator on OC at the end of a load if any unsatisfied 
REFs were encountered during the loading process. 


i i BEGIN IDLE 


Job Control Processor has read a FIN card, which completes a job stack. The back- 
ground then goes into an idle state. Processing will resume on a new job stack fol- 
lowing an unsolicited key-in of C. 


!!EOT ON FILE xxxxxxxx 


End-of-Tape status was returned from an attempt to read or write the indicated 
RAD file. 


!!ILL. NEG. ORG ITEM 


JCP loader has encountered an origin item that it is not equipped to handle (an origin 
item that moves the load location counter in a negative direction). The load will be 
aborted. 


MILL. DEFINE FIELD ITEM 


JCP loader has encountered a define field item that it is not equipped to handle (a 
define field item that crosses a word boundary). The load will be aborted. 


!!TOO MANY CONTROL 
SECT. 


JCP loader has encountered more than one nonstandard control section. The load 
will be aborted. 


MILL. EXPRESSION 


JCP ioader has encountered an expression that it is not equipped to evaluate (a mixed 
resolution expression). The load will be aborted. 
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3. SYSTEM CONTROL COMMANDS 



The Monitor is controlled and directed by means of control 
commands. These commands effect the construction and 
execution of background programs and foreground programs 
loaded in from the background job stack, and provide com- 
munication between a program and its environment. The 
environment includes the Monitor and the Macro-Symbol, 
Symbol, FORTRAN IV-H, SL-1, Overlay Loader and RAD 
Editor processors, the operator, and the peripheral equip- 
ment. The two service processors (the Overlay Loader and 
RAD Editor) have their own subcommands that are defined 
in the appropriate chapters. 



MONITOR CONTROL COMMANDS 

CONTROL COMMAND FORMAT 

Control commands have the general form 
/ ! mnemonic specification 



JOB CONTROL PROCESSOR 

The Job Control Processor (JCP) reads all Monitor control 
commands from the device designated by the "C" opera- 
tional label. The JCP is a special processor loaded into 
the background by RBM upon the initial "C" key-in. The 
JCP is also reloaded into the background following each job 
step within a job. A job step is defined as all control com- 
mands required for the setup and execution of a single pro- 
cessor or user program within a job stack. (See Figure 1 
for an example of a two-step job.) 

The JCP processes each control command until a request is 
made to execute a processor or user program, at which time 
the appropriate program is read into the background and 
given control. 



! is the first character of the record and identifies 

the beginning of a control message. 

mnemonic is the mnemonic code name of a control 

function or the name of a processor. The name may 
begin any number of spaces after the ! character, 
except an !EOD command. 

specification is a listing of required or optional speci- 

fications. This may include key words, labels, and 
numeric values appropriate to the specific command. 

In this manual, the options that may be included in the speci- 
fication field of a given type of control command are shown 
enclosed in brackets (actually no brackets are used in con- 
trol commands) and parentheses are required to indicate the 
grouping of subfields. For example, see the options given 
for the LOAD control command. 



!FIN 



Second Job Step 



First Job Step 




FORTRANH Compiler (Binary Deck) 




:ROOT (DEVICE, CRA03) 



(MAP, ALL) 



lOLOAD (FILE, SP, FORTRANH); 



:(FSIZE, 160) 



:ALLOT (FILE, SP, FORTRANH); 



IRADEDIT 



x 



\ 



!ATT 



UOB 



Figure 1. Job Stack with Two Job Steps 



12 System Control Commands 



SEPARATORS AND TERMINATORS 

One or more blanks may separate the mnemonic and specifi- 
cation fields, but no blanks can be embedded within a field. 
A control command is terminated by the first blank after the 
specification field; or, if the specification field is absent and 
a comment foi lows the commanvj, tne commana is terrninarea uy 
a period aftera blank that follows the mnemonic field. Anno- 
tational comments detailing the specific purpose of a command 
may be written foi lowing the command terminator, out no con- 
trol command record can contain more than 80 characters. 

CONTINUATION CARDS 

A control command can be continued from one record to the next 
by using a semicolon to replace the comma as a subfield termi- 
nator in the command'sspecification field. Column 1 of the 
continuation cards must contain eitheran exclamation mark (for 
a command read by the Job Control Processor) or a colon (for 
subcommands read by the Overlay Loader or RAD Editor). 

If there is an error in a continuation card, the entire com- 
mnnH must be re— incut after correction. 

COMMAND MNEMONICS 

For all control commands, the first three characters of the 
mnemonic following the exclamation character are sufficient 
to define any mnemonic code or keyword. 

Example: 

The mnemonics 

! ALL 
! ALLO 



! ALLOB 
! ALLOBT 

are all legal representations for the ! ALLOBT control 
command. 



LOGGING CONTROL COMMANDS 

Control commands are usually input to the Monitor via 
punched cards; however, any input device(s) may be desig- 
nated for this function (see ASSIGN command). All control 
commands are listed on the output device designated as the 
listing log (normally a line printer) as they are read. In this 
manner, the Monitor keeps the operator informed regarding 
the progress of a job. Control commands that are skipped 
over until the next JOB command is encountered are listed 
with a "greater than" character (>) in column 1. 



CONTROL COMMAND REPERTORY 

All acceptable RBM control commands are given in Table 6, 
and are listed in a logical, but not necessarily typical, op- 
erating sequence. Sample parameters are given in the "Ex- 
ample" column only to illustrate typical parameter formats. 

A complete explanation of the parameters is not given. (A 
more detailed description is given in the XDS Sigma 5/7 
RBM Reference Manual.) Note that this table lists only the 
standard commands recognized by the Monitor; the commands 
for the two service processors (Overlay Loader and RAD 
Editor) are given in their respective sections of this manual. 



Table 6. RBM Control Commands 



Uenerai Form 


Example 


Meaning 


! JOB [account number,name] 


! JOB 13962,SAMPL 


Starts a new job and signals end of any previous 
job. Resets all operational labels to their standard 
assignments. 


! ATTEND 


! ATTEND 


Indicates that recovery action is to be attempted 
at the console in case of program error or abort in 
the background. An unsolicited C key-in causes 
the background to continue processing from point 
of error. If an ATTEND command is not used and 
a job aborts or error occurs, all commands, binary 
records, and data are skipped until a new JOB or 
FIN command is encountered. 


! ASSIGN (dcb[area,name]) , 

1 

' [,(option), (option), . . . , (option)] 


! ASSIG (M:LO,9TA81),VFC 

or 

! ASSI (M:SI,Dl,PRESTORE) 


Specifies the physical devices or RAD files to be 
used to process the current job. Each ASSIGN 
assigns a Data Control Block name to an opera- 
tional label (logical device name), a RAD file, or 
physical device. ASSIGN commands must appear 
prior to the appropriate RUN or Processor name 
command and affect only that one job step. 


1 PMD ("ill T (from to)~l . 


! PMD 11,(1200,1300), 
(2000,3000) 


Dumps specified areas of memory on the DO de- 
vice if a background job is aborted or terminated 
normally during execution. The U parameter 




1 [,(from,to)]... 
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Table 6. RBM Control Commands (cont.) 



General Form 


Example 


Meaning 






specifies an unconditional dump at the end of 
the job even if there were no errors. If the 
(from,to) locations are not specified, the entire 
background area is dumped. The command must 
precede the RUN command. 


! LIMIT n 


! LIMIT 3 


Sets the maximum allowable execution time for a 
background program in minutes. If the job ex- 
ceeds the limit, it is aborted with a postmortem 
dump if so specified via a PMD command. 


! ALLOBT(FILE f nn)[ f option)— | 


! ALLO (FILE,Xl),(FORMAT,-| 


Defines the files in the BT (Background Temp) 
area of the RAD and overrides any JCP default 
definitions. 


' (,option) . . .] 


1 — C),(FSIZE,1000),SAVE 


! STDLB (label [,area] / name) —i 


! STDLB(BO,GO),(CO,D2,^ 


Changes the assignment of an operational label 
(except operator's console) to a temporary as- 
signment that stays in effect until the next JOB 
command is encountered. 


' [,(label [,area] ,name). . .] 


1 — COMPRESS),(LO,9TA80) 


! LOAD [(option),(option)] 


! LOAD(IN,CRA03),(OUT,SP,-j 


Loads a program on the RAD with absolute linkage 
for its core execution location. Foreground pro- 
grams can only be loaded on the OV file or FP 
area of the RAD. 


1 — OLOAD),(SEG,5),MAP 


!EOD 


!EOD 


Defines the end of each block of data within a data 
deck. Monitor returns an EOD status when each 
EOD command is encountered. Any number of 
EOD commands can be used in a job and for any 
purpose. There must be no space between the ex- 
clamation character and the mnemonic. 


! CC 


! CC 


Removes typewriter override of the C device (see 
TY key-in description in Chapter 2). The next 
control command will be read from the C device 
instead of the typewriter. 


! MESSAGE message 


! MESSAGE SEND ALL SAVE-, 


Types a message to the operator on OC and LL 
devices. Processing continues without pause after 
message is output, and no operator intervention at 
the console is necessary. 


1 TAPES TO DICK WEAVER 


i n a i i rr 
'. TMUOC 


! PAUSE KEYIN SY 


v-uuses trie monitor to enter a waaIT state after a 
message is output on OC, giving the operator time 
to carry out the instruction in the message. Pro- 
cessing continues after a (unsolicited) C key-in. 


! POOL n 


! POOL 3 


Overrides the default allocation of blocking buf- 
fers for the background. Ccuses n blocking buf- 
fers to be allocated. 


! RUN area, file name 


! RUN BP,SORT 


Causes the named program to be executed. The 
area parameter must be either bf, YY , or BK. 1 he 
loading of a program into the foreground area via a 
RUN control command must be preceded by an FG 
key-in. Remains in effect for a single job step only. 
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Table 6. RBM Control Commands (cont.) 



General Form 


Example 


Meaning 


! ROV 


! ROV 


The ROV (RUN OV) command causes execution 
of the program on the OV file. The loading of 
any program into the foreground area via an ROV 
control command must be preceded by an FG key- 
in. A foreground program loaded by 1 ROV is 
given the name OV. 


! PFIL [area,] name [,BACK] 

! PREC [area,] name [,BACK][,n] 


IPFIL GO 

! PREC D1,ABCD,30 


File and record positioning commands used to 
position a device within its current file. The 
PFIL command is only valid for magnetic tapes 
or RAD files and leaves the device positioned 
before the file mark in the appropriate direction. 
Only background devices (not dedicated to fore- 
ground or IOEX) can be positioned. 


! SFIL name[,BACK][,n] 


!SFIL9TA82,BACK,4 


Skips one or more files on a magnetic tape unit. 
It cannot be used to position a RAD file. The 
command positions the deivce immediately fol- 
lowing the specified tape mark in the appropriate 
direction. Only undedicated devices can be 
positioned. The n parameter specifies the num- 
ber of files to skip. 


! REWIND [area,] name 


! REWIND 7TAEO 


Rewinds a magnetic tape or RAD file. It has no 
effect on other devices. 


! UNLOAD [area,] [name] 


! UNLOAD D4,OUTPUT 


Causes the specified magnetic tape to be rewound 
in manual mode. Operator intervention is re- 
quired to use the device again (i. e. , depressing 
the ATTENTION and START switches on a tape 
device). For a RAD file, UNLOAD produces the 
same results as a REWIND command. 


1 WEOF [area,] name [,n] 


! WEOF 9TA81,2 


Causes an end-of-file mark to be written if ap- 
orooriate to the device^ For magnetic tape, a 
tape mark is written; for a RAD file, a logical 
file mark is written; for paper tape a !EOD rec- 
ord is written. The WEOF command is ignored 
for all other devices. The n parameter specifies 
the number of end-of-file marks to write. 


! DAL [PAL] 


! DAL PAL 


Causes the contents of the accounting log (on theAL 
file on the Dl RAD area) to be dumped. The PAL op- 
tion causes the AL file to be purged after dumping. 


! FIN 


! FIN 


Specifies the end of a stack of jobs and no jobs 
are pending. When the FIN command is en- 
countered, it is written out on LO to inform the 
operator that all current jobs have been com- 
pleted. The Monitor types out "BEGIN IDLE" 
on OC and enters the idle state. 


! MODIFY (module,loc),value[R] 




Special control command used only for modifying 
(patching) system modules at system boot time. See 
Appendix E, "System Patching" in the Sigma 5/7 
RBM Reference Manual (Publication No. 90 15 81) 
for complete description and use. 
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PROCESSORS/MONITOR INTERFACE 

All processors, whether service, system, or user, reside on 
the Systems Program area of the RAD, operate in the back- 
ground core space, and are called from the Systems Program 
area for execution by the control command 



A 



! name parameters 



name is the RAD file name of the processor to be 

executed. The standard name format for service 
and system processors is as follows: 



Name Format 

lOLOAD 

IRADEDIT 

1MACRSYM 

! SYMBOL 

IFORTRANH 

!SL1 



Processor Called 

Overlay Loader 
RAD Editor 
Macro- Symbol 
Symbol 

FORTRAN IV-H 
SL-1 



Veal-Time FORTRAN IV-H is called by using the RT op- 
tion in the parameters of a IFORTRANH command. 



parameters are optional parameters interpreted by 

each processor except the IRADEDIT command, 
which does not need parameters. The options for 
all system processors recognized by RBM are de- 
fined in Table 7. (See "Related Publications" at 
the beginning of this manual for manuals giving a 
more detailed description of the system processors.) 

A typical example of a processor called in by a user's source 
program for an assembly is given below. 

Example: 

/iMACRSYM SI,LO,CI,BO 



This control command specifies that control is to be given 
to the Macro-Symbol assembler. The SI parameter speci- 
fies that symbolic (source) input is to be read from the de- 
vice to which the SI operational label is assigned; the LO 
parameter specifies the device to which the listed output 
is to be written; the CI operational label specifies the de- 
vice from which the compressed input is to be received; and 
the BO operational label specifies the device to which the 
binary output is to be transmitted. 



Table 7. Processor Specifications Options 



Specification 


Use 


Used By 


BA 


Selects batch assembly mode 


Macro-Symbol 


BO 


Relocatable binary output (on cards or paper tape) on 
the BO device. 


FORTRAN IV-H, SL-1, 
Symbol, Macro-Symbol 


CI 


Compressed input from the CI device 


Macro- Symbol 


CN 


Concordance listing 


Symbol 


CO 


Compressed output on the CO device 


Macro-Symbol 


D 


Debug mode compilation 


FORTRAN IV-H 


GO 


Relocatable binary output to temporary RAD storage 
(i.e., the GO file) 


Symbol, Macro-Symbol, 
SL-1 


LO 


Listing output produced on the LO device 


FORTRAN IV-H, Symbol, 
Macro- Symbol, SL-1 


LS 


Source Listing produced on the LS device 


FORTRAN IV-H, SL-1 


LU 


Listing of the update decks (if any) produced on the 
LO device 


Macro-Symbol 


S 


S in column 1 


FORTRAN IV-H, SL-1 


SI 


^v/mknlir Innnf frrtm fne ^T Ac*\i\t~e± 


Macro— Symbol - SL— 1 


SO 


Symbolic (source) output produced on the SO device 


SL-1 
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4. RUNNING BACKGROUND JOBS 



JOB DEFINITION 

The fundamental unif in background processing is the job. 
A typical job might consist of the following elements: 

1. A JOB command card to signai the beginning of a new 
job. The Monitor resets all operational labels to their 
permanent assignments. 

2. Optional ASSIGN or STDLB commands that define to 
the Monitor the peripheral devices and RAD files that 
are to be used for I/O. These commands are only 
needed to change the inherent I/O assignments in a 
program. 

3. A processor command that calls in the correct system 
processor (e.g., Macro-Symbol assembler), user pro- 
gram (or combination), or a RUN command to execute 
a program. 

4. Any source data the program is designed to process. 
The data may be contained in a card deck, magnetic 
or paper tape, or on a RAD data file. 

A number of optional control commands can be included in 
a job, such as a LIMIT command to set the allowable exe- 
cution time for a given program. Figure 2 illustrates the 
simplest case of a deck setup for a job. 



A 



!FIN 



Source Deck 



1MACRSYM SI, LP 



!JOB 



\ 




Figure 2. Source Program Assembly Example 

In Figure 2, the symbolic input" is received from the SI de- 
vice and the listing oufpuf is produced on the LO device. 



LOAD AND GO JOBS 

"Load and Go" jobs are programs that immediately go into 
execution mode when the source program is successfully as- 
sembled or compiled. That is, the object program is loaded 
into core from a temporary file on the RAD when the assembly 
is completed instead of being manually loaded from a card 
or tape device by the operator. Figure 3 illustrates a typi- 
cal "Load and Go" job. 



!FIN 



!ROV 



!PMD 



! OLOAD (MAP, PROGRAM), (GO) \ 



Jl 



Source Deck 



! MACRSYM SI,LO,GO 



IJOB 



7^ 
VI 



f 



Figure 3. Load and Go Deck Example 

In Figure 3, the binary object program produced from the 
assembly is placed in a temporary (GO) file from which it 
is later loaded into core for execution. The resultant file 
is always temporary and can not be retained from one job to 
another. The Overlay Loader will load the program root into 
the OV file for execution. A postmortem dump is specified. 



BATCH JOBS 

Batching permits a user to load a series of source or com- 
pressed programs for assembly or compilation under a single 
system processor ccnirci corrirnanu. ms parameiers speci- 
fied on the processor command will hold true for every job 
within the batch. 

When batch assemblies consist of successive updates from 
card input to compressed programs from the RAD or tape, 
each update packet is terminated by a +END card, not by 
an !EOD card. There must be a one-to-one correspondence 
of update packets to compressed programs. If there are no 
updates to a particular program in a batch, the "missing" 
update packet must be represented by a +END card inserted 
in the proper place in the update deck. The example illus- 
trated in Figure 4 is a typical batch job. 

In Figure 4, successiveassembliesare performed with asingle 
MACRSYM command until a double EOD is read. The device 
assignments and options on the MACRSYM command apply to 
all assemblies within the batch. A program assembly is con- 
sidered terminated when an END Macro-Symbol directive is 
processed. 

JOB STEPS 

A job step is the execution of a program (system processor or 
user program) in the background. The processors that operate 
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!FIN 



!EOD 



EOD 



Compressed Program 



M 




+END 



Update Deck (Source) 




EOD (Optional) 



J 



M 



Compressed Program 




-END (No Updates) 



EOD (Optional) 



Compressed Program 




+END 



Mm 



Update Deck (Source) 




1MACRSYM SI,CI, LO,BA 



JOB 



J 



J 



Figure 4. Batch Job Example 



under RBM are service processors (RAD Editor and Over- 
lay Loader) language processors, and user processors. 
Service and language processors are supplied with the 
RBM system. User processors are created at the local 
installation. 



GENERAL OPERATING CONSIDERATIONS 

The basic types of background jobs the operator may en- 
counter fall in the following general categories: 

1. Assemblies or compilations of original source pro- 
grams (written in some symbolic language such as 
FORTRAN IV-H or Macro-Symbol) into object mod- 
ules. The output from such a job might include a 



source listing, an object listing, and an object pro- 
gram deck. 

Trial executions of partly debugged programs called 
"test cases". Sample data is loaded and the pro- 
gram processes the data under various conditions. 
Additional control command options may be used to 
vary the processing of data or format of the final 
output. 

Processing data by an operational program. Such pro- 
grams generally reside in the Background Programs 
area of the RAD if they are frequently or regularly 
used. Less frequently used programs may be loaded 
from a card reader or tape device. Data to be pro- 
cessed can oe locafea in tne ioregrounu or background 
data areas of the RAD or input from some other ex- 
ternal source. 
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BACKGROUND JOB RESTRICTIONS 



ERRORS IN JOB STREAM 



The Monitor imposes two fundamental restrictions in pro- 
cessing background programs: 



Background programs are given CPU time only after 
real-time hardware interrupts are satisfied. That is, 
nothing can take place in the background that inhibits 
interrupts or in any way interferes with real-time re- 
sponsiveness. Thus, background programs will not be 
guaranteed any processing time if the foreground is 
very active. 

The Monitor prevents any attempt by a background 
program to write into or execute instructions in 
foreground core storage, to write Into foreground RAD 
file areas, or to utilize devices or services dedicated 
to real-time tasks. Any attempt by the background 
program to violate this protection or to execute privi- 
ledged instructions, either intentionally or through 
program error, may result in the Monitor aborting the 
background program. 



There is no read protection for the foreground areas, and 
background programs can read from real-time core storage 
and secondary (RAD file) storage without restriction. A 
typical example of using the read feature would be a real- 
time data acquisition program that accumulates real-time 
data and writes it out on the foreground data file area of 
the RAD. A background program could then be loaded at 
a later, less critical period to read and further process the 
data without disturbing the raw data that might be needed 
for some further real-time task. 

Frequently used user programs reside on the RAD in load 
module form in the BP area and are called via a Iname com- 
mand, where name is the name of the file. 



In running assemblies or compilations, those errors from 
which the operator can recover are generally control com- 
mand sequence or format errors (i.e., a mispunched card); 
when processing data with an operational program, data 
format errors are a frequent cause of jod aoort and it may be 
necessary to take a dump of the data file. 



During processing of the job stream, the Monitor will go 
into a WAIT state after outputting a request on the oper- 
ator's console to ready some device or load data input, 

OPERATOR INTERRUPT DURING CONCURRENT 
FOREGROUND BACKGROUND OPERATIONS 

If the operator depresses the INTERRUPT switch during con- 
current foreground/background operations (perhaps to change 
the status of a background job), the Monitor will not ac- 
knowledge the interrupt with a ! IKEY-IN message until all 
current and waiting foreground processes are completed. 
This is because the Control Task that processes the key-in 
is connected to the lowest priority interrupt in the system. 
For the same reason, the operator cannot alter the current 
foreground task, 

ATTENDED RUNS 

Attended runs are frequently specified when new programs 
are submitted for processing. An IATTEND control command 
in the user's job will inhibit the Monitor ABORT routine, and 
the Monitor will go into a WAIT state if it encounters an 
error if cannot correct. This gives the operator time to take 
memory dumps or initiate recovery action, if possible. If 
recovery procedures cannot be successfully completed, the 
operator's only recourse is to abort the job through an "X" 
kev-in after taking any specified dumps. 
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5. RUNNING FOREGROUND JOBS 



OVERVIEW 

Operator control and manipulation of foreground programs 
requires a knowledge of some of the characteristics of such 
programs and of how core memory is partitioned. The posi- 
tioning of memory into various areas such as the systems 
area, foreground area, foreground blocking buffering area, 
background area, background buffering area, etc., is 
installation-determined during SYSGEN and becomes the 
standard default allocation. In a typical installation, core 
memory will be allocated as is illustrated in Figure 5. 










RBM System Area 




Background Area 


Background Blocking Buffers Area 


Foreground Area 


Foreground Blocking Buffers Area 









Figure 5. Typical Core Memory Partitioning 

The boundary of the background blocking buffers area is 
not static, but can shift into the background program area, 
depending upon the number of blocking buffers present, 
which can vary from job step to job step. The first-word 
address (FWA) of the foreground memory area can be moved 
up into the background through an FMEM key-in if more 
foreground core space is required. 

Several foreground jobs can be resident simultaneously in 
protected core; the number that can be resident is deter- 
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Table established during SYSGEN. 



Each foreground program in core will be connected to one 
or more interrupts. While these interrupts are generally 
triggered from outside the system, the signal can be internal; 
that is, one foreground program can trigger execution of 
another program or the signal can be received from an in- 
ternal interval timer (real-time clock). Each interrupt has 
a different priority level, and when more than one interrupt 
is in a waiting state, this priority level determines which 
program will next become active. 



TEMPORARILY INACTIVE FOREGROUND 

A foreground program may be resident in core with all inter- 
rupts armed and enabled, but be temporarily idle. That is, 
it can be waiting for a new interrupt to be triggered before 
resuming execution. Care must be exercised in reallocating 
core when such programs are present in the system, since 
the apparent lack of activity may lead to a belief that they 
have completed. When the program is released, the message 

NPROG xxxxxxxx RELEASED 

will output on the OC device. Space will now be available 
for a different foreground program, or it may be possible to 
move the foreground boundary to make more core space 
available to the background. 



CONSOLE INTERRUPT PRIORITY LEVEL 

To prevent accidental interference with critical real-time 
processes, the Console Interrupt Task triggers the RBM 
Control which is normally the lowest priority interrupt in 
the system. This prevents the Monitor from processing a 
key-in until the active interrupt and any pending interrupts 
have been processed. The system will then acknowledge 
an operator initiated interrupt with a 

!! KEY-IN 

message on the OC device. 
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REAL-TIME INTERRUPTS 



Foreground programs are frequently loaded and initialized 
at System Boot-time. Program execution is initiated when 
a signal is received from some external source, such as 
telemetry equipment, factory equipment, or a medical de- 
vice in a hospital. The signal causes triggering of an 
interrupt that initiates execution of its connected task 
(a body of code within the program). 



Before any foreground program can be loaded into core for 
execution, it must have been previously loaded onto the 
RAD in absolute core image format, where it will reside 
either in a file in the FP (Foreground Programs) area or on 
the OV file. The request to RUN the program is initiated 
in one of four ways: 

i\«jiN name Key— in, wnere name is tus name o-, a 

program in an FP area 

ROV key-in, to run the program currently on 

the OV file 
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!RUN name control command, read in from the 

background job stack on the CC device for the 
named program in the FP area. The command 
must be preceded by an FG key-in. 

!ROV control command, read in from the back- 

ground job stack for a job located in the OV file 
(Only one job at a time is permitted on the OV 
file and is always called OV. ) The command 
must be preceded by an FG key-in. 

When the RBM system encounters the request to RUN, it per- 
forms the following steps: 

1. LOAD: The RBM system reads the program header, 
which specifies the program's required core location 
and size, and tests if the required core space is avail- 
able. If the foreground program extends into the cur- 
rent background core space and a background program 
is active, the background program is checkpointed and 
the foreground program is read into core from the RAD. 
The message 

! ! LOADED PROGRAM xxxxxxxx 
will be output on OC. 

2. INITIALIZATION: Control is transferred to the pro- 
gram entry at the RBM Control Task priority level. The 
steps the program then follows depends on its structure, 
Typical steps for execution could be the following: 

a. Arm and enable interrupts. 

b. Set up interval timers (the timers define the time 
delay between the triggering of interrupts). 

c. Connect the tasks to their interrupts. 

d. Trigger the interrupts. 



RELEASING FOREGROUND PROGRAMS 

Release is accomplished through either operator key-in (RLS) 
if he wants to bump the program for a different program that 
requires some of the same core space, or through a system 
call from the active foreground program. In any event, the 
following actions will take place: 

a. All interrupts used in the program are disarmed, dis- 
abled, and disconnected. 

b. The memory space used by the program (both foreground 
and any background) is marked as unused. 

c. The checkpointed background program (see below) is 
restarted unless the core space is needed by a new fore- 
ground program. 

To release an active foreground program and load another 
foreground program through the RLS key-in, proceed as 
follows: 

1. Depress console INTERRUPT key. This causes a flag to 
be set and the RBM Control Task to be triggered. Since 



the Control Task Interrupt is the lowest priority in the 
system, it will not be recognized until the active fore- 
ground interrupt and any waiting interrupts have com- 
pleted their execution cycle. The system will then out- 
put the 

i KEY-IN 

message on the OC device. 

2. Key-In 

RLS ( 0V ) 

tname) 

where 

OV is the foreground program currently in the OV 

file. 

name is the name of a currently active program that 

is located in the FP area of the RAD. 

When the active program is successfully released, the sys- 
tem will output the message 

! IPROG xxxxxxxx RELEASED 

on the OC device. 



CHECKPOINTING BACKGROUND 

When real-time programs are running concurrently with back- 
ground programs, a foreground program can borrow core 
storage space from the active background program if neces- 
sary. When a request is made to RUN a foreground program 
that requires some portion of memory currently in the Back- 
ground area, the system will borrow the background space 
for the foreground by storing the background area on secon- 
dary (RAD) storage and saving the status, This procedure is 
called checkpointing. The system will output the 

HBCKG CKPT 

message on the OC device to inform the operator that check- 
point has taken place. No operator action is required. 

If background I/O is taking place when the checkpoint is 
attempted, the system will immediately output the message 

!!CKPT WAITING FOR BCKG I/O RUNDOWN 

on OC, since the foreground cannot seize background mem- 
ory until the current background I/O has completed. When 
the I/O has terminated, the checkpoint proceeds. 



RESTART 

When the foreground program is released and no longer re- 
quires the borrowed background memory space, the system 
will restart the background job step by reading the saved 
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image from secondary storage and resuming execution. 
It will then output the message 

HBCKG RESTART 



Should any foreground program be resident in any portion 
of memory being returned to the background, the message 

! !FDG AREA ACTIVE 



on OC to inform the operator that the checkpointed pro- 
gram has been restarted from its interrupted point. No 
operator action is required. 



PREVENTING CHECKPOINT 

When a foreground program is loaded into core for execu- 
tion, it is sometimes useful to prevent checkpoint of a back- 
ground program. This can be done by allocating sufficient 
space to the foreground through the FMEM key-in. The 
operator keys-in 



FMEM 



y 



where y is the new number of pages to be allocated to the 
foreground. Any change in memory allocation as a result 
of the FMEM key-in does not actually take place until the 
conclusion of the current background job step. 



RESTORING MEMORY 

When the foreground program is released, either through 
normal completion or operator RLS key-in, the operator may 
restore the background/foreground boundary through an 

FMEMy 

key-in, where y is the number of pages of memory to be 
allocated to the foreground. 



will be output by the system, and memory will not be re- 
turned until the foreground program is released. 



OPERATOR INTERVENTION 



Foreground programs already operational in the system al- 
most never require operator manipulation. Occasionally, 
the Monitor may output a status message that the background 
has been checkpointed or restarted, or request the operator 
to ready some special purpose device. 



ERROR RECOVERY 

Error recovery for operational foreground programs is im- 
possible in most cases, and the operator's only recourse is 
to call the designated person or Customer Engineer (for a 
clearly evident machine malfunction). 

LOADING NEW FOREGROUND JOBS 

New foreground programs can be loaded into the foreground 
programs area of the RAD from the background job stack 
without a new SYSGEN. Operator handling of such pro- 
grams is identical to background jobs except that loading 
must be preceded by an SY key-in to access protected RAD 
areas. Figures 6 and 7 illustrate typical examples of load- 
ing foreground programs from the background job stream. 
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!FIN 
!RUN FP,FINT 



\ 



- 



Binary Object Deck 




:ROOT(ENTRY,INIT),(DEVICE,CRA03f 



:(FILE # FP, FINT), (MAP, PROGRAM) 



IOLOAD (FORE), (TASKS,!): 



! ALLOT (FILE, FP, FINT), (FSIZE, 25 ) 



IRADEDIT 



! MESSAGE FROM BG STACK 



! MESSAGE LOADING FG TEST JOB 



IATTEND 



! PAUSE KEY-IN FSC 



\ 



UOB 



In this example,- the RAD Editor allots a file (FINT) in the Foreground Programs (FP) area of the RAD. The Overlay- 
Loader (see Chapter 7) loads the binary object deck in the file FINT in core image format. The !RUN control com- 
mand causes execution of the foreground program. A PROGRAM map is specified. 

Figure 6. Load and Execute Foreground Program 
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M 



!FIN 

!RUN FP,FSEG 



Binary Object Deck 




:(EXLOC, 7C00), (DEV, CRA03) 



:SEG (LINK 2, ONTO, 0); 



J™ 



M 



Binary Object Deck 




:(EXLOC, 7A00), (DEV, CRA03) 



:SEG (LINK 1,ONTO r 0); 



Binary Object Deck 




:(DEV,CRA03) 



:ROOT (ENTRY, OVFOR); 



:(FILE,FP, FSEG), (MAP, ALL) 



J 



IOLOAD (FORE), (TASKS, 1); 



:ALLOT (FILE,FP,FSEG),(FSIZE,25) 



IRADEDIT 



1MESSAGE FROM BG 



1MESSAGE LOADING FG TEST JOB 




In this example, the RAD Editor allots space for a file called FSEG in the Foreground Programs (FP) area of the RAD. 
The Overlay Loader (see Chapter 7) loads a root and two segments into FSEG in core image format. Following an 
operator FGC key-in., the overlaid nroaram is executed via the !RUN control command. An ALL map is reauested. 



Figure 7. Load And Execute Segmented Foreground Program 
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6. RAD EDITOR OPERATIONS 



Before any job or data can be loaded on the RAD for execu- 
tion, if must be allocated file space in the appropriate RAD 
area. The RAD Editor is caMed in by the user's job to per- 
form this function via a IRADEDIT control command. Sub- 
sequent :ALLOT subcommands read by the Editor define the 
file or files to be used. 

The RAD Editor maintains order in all the permanent RAD 
areas through use of file directories for each area. As 
files are added to a given area, the Editor generates a new 
file entry in the appropriate directory so that fiies can be 
located on demand. The permanent RAD areas that have 
file directories are 

Foreground Programs area 

Background Programs area 

System Programs area 

Data areas (foreground and background) 

In addition to allocating space for new entries, the RAD 
Editor performs the following functions: 

Deletes entries from the permanent file directories. 

Enters data files on the foreground or background data 
areas. 

Compacts permanent file directories and RAD areas. 

Truncates empty space from the end of files. 

Maps permanent RAD file allocations. 

Dumps contents of RAD files or areas. 

Copies permanent RAD files. 

Copies object modules contained in libraries. 

Saves contents of RAD areas on a magnetic or paper 
tape device (SAVE tape) in self-reloadable form. 

Restores previously saved RAD areas to their RAD 
location. 

Maintains library files on the RAD for Overlay Loader 
use. 

Zeros out (clears) complete RAD areas. 

Temporarily inhibits and restores use of bad RAD tracks 
in permanent areas. 



modified that do not require an SY key-in are the Back- 
ground Data areas. The message 

! ! yyndd WRT PROT 



! ! PAUSE KEY-IN SY (if included in the job stack) 

will be output on OC to inform the operator that access to 
a protected RAD area is requested. 

CALLING RAD EDITOR 

When an ! RADEDIT control command is read from the C de- 
vice, the RAD Editor is loaded into core memory from the RAD. 
Control is transferred to the RAD Editor which reads com- 
mands that specify the functions to be performed. 

COMMAND FORMATS 



All RAD Editor commands are input from the C device and 
listed on LL The general form for RAD Editor commands is 
identical to the Monitor control command format described 
in Chapter 3, with the symbols below being used to aid in 
describing the RAD Editor commands given in Table 8. 

aa refers to a permanent RAD area and must be one 

of the following: 



BP 



is the Background Programs area. 



D] through DF is the Background and Fore- 

ground Data areas. 

FP is the Foreground Programs area. 

SP is the System Programs area. 

zz refers to any RAD area 

nnnnnnnn refers to a file name or library module 

(maximum name length of eight alphanumeric 
characters). 

yyndd refers to a physical device name, where 

yy specifies the type of device: CR, CP, etc. 

n specifies the IOP number: A for IOPO, 

Bfor IOP1, etc. 

dd specifies the device number: 03, 80, etc. 

op refers to an operational label: BI, SI, etc. 



RAD AREAS PROTECTION 

Software protection of the SP, FP, BP, and foreground data 
areas of the RAD is provided by requiring the operator to 
key-in "SY" before any of these areas are modified by a 
background processor. The only areas that can be 



All RAD Editor commands are itemized in Table 8. The 
entries in the "Example" column are given only to illus- 
trate typical command formats. For brevity, detailed ex- 
planations of the parameters for each command is not given 
(a detailed description for each command is given in the 
XDS Sigma 5/7 RBM Reference Manual). 
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Table 8. RAD Editor Commands 



General Form 



Example 



Meaning 



1RADEDIT 



IRADEDIT 



Call the RAD Editor into core to 
read subcommands. 



:ALLOT (FILE^a/nnnnnnnn^^option)] 



L 



J 



:ALLOT (FILE, BP, TEST, (FORMAT,U), 



[, (option)] [, (option)]. . .[, (option)] 



(FSIZE,50),(RSIZE / 90) 



Add a new entry to specified perma- 
nent file directory that allocates space 
for a new file. 



:COPY , 



FROM 
FILE,aa [,nnnnnnnn] 
LIB,aa,nnnnnnnn 



:COPY (IN,CRA03),(FILE,D1,XYZ) 
ICOPY (FILE,D1,XYZ),(OUT,9TA80) 



TO 

FILE,aa [,nnnnnnnn] 
LIB,aa 

out 'W 



L~ 



[,VFC][,ADD] [,BIN][,CC][,FBCD] 



Copy single data files or modules from 
one device to another. If nonstandard 
binary (BIN) or control commands (CC) 
are copied from the C device, operator 
must assign the C device to when the 
message ! ! KEY-IN STDLB C,0 is out- 
put, and reassign when ! ICOPY 
ENDED appears. An IATTEND com- 
mand must be present in the job when 
the BIN and CC options are specified. 



:DELETE 



([file]' 00 ' 



nnnnnnnn J 



: DELETE (FILE, BP, TESTA) 



Delete a file directory entry and file 
from specified permanent RAD area, 
or an object module from designated 
iibrary. 



:CLEAR zz,zz 



:CLEAR D1,DF 



Zero out (clear) specified RAD areas. 



:SQUEEZE aa,aa,aa,, 

or 

:SQUEEZE ALL 



:SQUEEZE SP 



Regain unused space within permanent 
RAD areas resulting from file deletions 
and truncations, and library module 
deletions. 



:TRUNCATE (FILE,aa,nnnnnnnn [,g]) 



L 



3 



rTRUNCATE (FILE, BP, TEST) 






(FILE,aa,nnnnnnnn [,g] 



.•TRUNCATE aa,aa,aa, . . . 



Truncate empty space from the end of 
specified file(s) by allocating space 
equal to the actual length of the file. 
For a direct access file, the length of 
the fi le must be specified in granules g. 



:MAP aa,aa,aa, . 



:MAP ALL 



:MAP BP,D4 



Map the specified permanent RAD 
areas to the LO device. 
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Table 8. RAD Editor Commands (conf.) 



General Form 


Example 


Meaning 




:DUMP (FILE,BP,TEST) 
:DUMP BP,(SREC,6),(EREC,9) 


Dump designated random or sequential 
access file onto the specified LO de- 
vice in hexadecimal. All permanent 
RAD areas, plus the IOEX access can 
be dumped. The first form of the 
:DUMP command dumps specified fiies; 
the second form dumps RAD areas. 


1 '™' nnnnnnnnJ t 


•— [,SREC,va!ue)][,EREC,va!ue)J 
or 
:DUMP zz [,(SREC,va!ue)][,(EREC,va!ue)] 


:SAVE zz,zz,. . . 

or 

:SAVE ALL 


:SAVE SP,BP,D2 


Dump specified RAD area(s) onto the 
BO device (must be magnetic or paper 
tape) for subsequent restoration. If 
BO is magnetic tape, it is rewound 
and data saved is verified. If tape 
verifies correctly, the message, 'SAVE 
TAPE OKAY' is output. The first form 
of the :SAVE command can specify any 
RAD area; the second form includes all 

D A r\ ~.~rx~- ~ 4. D 1 1 T_ — 

area and Checkpoint. 


RESTORE zz,zz, . . . 


rRESTORE SP,BP,D2 


Restore speci fied, permanent RAD areas 
saved via a :SAVE command. Read 
after write is employed to verify re- 
stored data. 


:BDTRACK yyndd,number[,number] . . . 


rBDTRACK DCAFO, 10,11 


Inhibit RAD Editor's use of specified 
number of tracks (hexadecimal) on the 
designated RAD. A track containing 
a sector of the file directory is not 
permitted to be removed from use. 


:GDTRACK yyndd,number [,numberj 


rGDTRACK DCAF0,10,11 


Restore RAD and specified hexadeci- 
mal number(s) of the tracks previ- 
ous!" inhibited from use by :BDTRACK 
command. 



RAD EDITOR DECK SETUPS 

Typical decks involving the use of the RAD Editor are illus- 
trated in Figures 8 and 9. 

In Figure 8, the CO operational label is assigned to a 
RAD file called COMPRESS in background data area Dl 
of the RAD. The compressed output is written on the 
COMPRESS file. 



be output to the card punch. The IREWIND command 
rewinds the magnetic tape assigned to 9TA80. When 
the RAD Editor encounters the IREWIND command, it 
releases control to the Monitor, so the next IRADEDIT 
command calls the RAD Editor back in to copy file 
XYZ to the magnetic tape. The Monitor writes an EOF 
on the tape and rewinds the tape. 



In Figure 9, the RAD Editor allots file XYZ to receive 
the card input to be copied. (Note that the RSIZE 
parameter on the :ALLOT command must contain 30 in- 
stead of 20 for binary card input.) The :COPY com- 
mand specifies that input is to be read from the card 
reader and copied to the XYZ file. The next :COPY 
command specifies that a copy of the card input is to 



RAD EDITOR ERROR MESSAGES 

The RAD Editor outputs error messages on the OC and LL 
devices. If OC and LL are assigned to the same device, 
duplication of messages on LL is suppressed. If an operator 
response is required, the RAD Editor will call the Moni- 
tor "WAIT" routine. The operator initiates a console 
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M 



!FIN 



Source Deck 




IMACRSYM SI, LP, CO 



".ASSIGN (M:CO, DECOMPRESS) 



:(RSIZE,30) 



:(FORMAT,B),(FSIZE,300) 



:ALLOT (FILE, DECOMPRESS); 



1RADEDIT 



!JOB 



Figure 8. RAD Editor ALLOT Example 



M 



•FIN 



! REWIND 9TA80 



1WEOF 9TA80 



:COPY(FILE,D1,XYZ),(OUT,9TA80) 



1RADEDIT 



! REWIND 9TA80 



:COPY (FILE, D1 / XYZ) / (OUT / CPA04) S 



!EOD 



Data Deck 



:COPY (IN, CRA03), (FILE, Dl , XYZ) 



:(FORMAT,B), (SIZE, 500) 



:ALLOT (FILE, D1,XYZ),(RSIZE,20); 



IRADEDIT 



\ 



!JOB 




Figure 9. RAD Editor COPY Example 
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interrupt and keys in one of fhe following commands to 
the Monitor: 

C Continue and read next record from the C device. 

X Abort RAD Editor and return control to Monitor. 

COC Continue and read a record from the OC 

device (used only in conjunction with the error 
message 'ERROR ITEM xx'). 

If the Editor aborts because of an irrecoverable I/O error, 
the physical device name is included in the abort message. 



The error messages output by the RAD Editor and their mean- 
ings are given in Table 9. 



RAD RESTORATION MESSAGES 



The messages itemized in Table 10 are written on the 
keyboard/printer during RAD restoration via the bootstrap 
loader produced by SAVE. Unless otherwise specified, the 
computer will go into a WAIT after writing a message. 



Table 9. RAD Editor Error and Status Messages 



Message 


Meaning 


Action Taken 


ERROR ITEM xx 


Item number xx on the command is 
in error. 


If operator response is C, Editor reads 
next record from C device. If operator 
response is COC, the next record is read 
from the OC device. This will enable 
operator to rectify a command error. 


ILLEGAL BINARY RECORD 


An illegal binary record (first byte 
not X'lC, X'3C) has been read 
with an object module. 


If operator response is C, Editor reads 
next record from specified device. 


CKSM ERROR 


Last record in the object module 
being read has a checksum error. 


If operator response is C, Editor reads 
next record from specified device. 


SEQ ERROR 


Last record in the object module 
being read has a sequence error. 


If operator response is C, Editor reads 
next record from specified device. 


EOT on f ^ ndd 

1 area,name 


Unexpected end-of-tape was en- 
countered on the specified device 
or file. 


Operation is aborted. 


yyndd WRT PROT 


Specified RAD is write-protected. 


Interrupt and key-in "SYC", or reset 
appropriate RAD protection switches. 
Or, if job is not allowed to write on 
protected areas of RAD, interrupt and 
key-in "X" to abort. 


RAD OVERFLOW 


Allocating the amount of RAD storage 
indicated by the "file" parameter on 
the :ALLOT command would cause the 
permanent RAD area indicated by the 
"directory" parameter to overflow. 


Operation is aborted. 


INVALID RSIZE. UNBLOCKED 
ORGANIZATION GIVEN 


Maximum record size for a blocked file 
has been exceeded. Unblocked organi- 
zation given. 


Editor continues. 


AREA xx IS NOT ALLOCATED 


Specified area was not allocated at 
SYSGEN 


Operation is aborted. 


KEY ERR 


Operator key-in is erroneous. 


Key-in has to be either C, COC, or X. 


SPECIFIED FILE DOES NOT 
EXIST 


File does not exist within the speci- 
fied area. 


Operation is aborted. 


DUPLICATE FILE 


An attempt has been made to allocate 
a file using a name which already exists. 


Operation is aborted. 
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Table 9. RAD Editor Error and Status Messages (cont. ) 



Message 


Meaning 


Action Taken 


ILLEGAL FILE NAME 


An attempt has been made to allocate 
a file using GO, OV, or X1-X9 as a 
file name. 


Operation is aborted. 


AREA xx CANNOT CONTAIN 
A RESIDENT FOREGROUND 
PROGRAM 


Illegal area specified. Only the FP 
area can contain a resident foreground 
program. 


Operation is aborted. 


AREA SPECIFIED DOES NOT 
CONTAIN A LIBRARY 


An area other than SP or FP was speci- 
fied that does not contain a library. 


Operation is aborted. 


TRACK xxxxx CANNOT BE 
DELETED 


Illegal attempt to remove a track from 
use containing a sector of the file 
directory. Removal would prevent ac- 
cessing of files or other sectors of the 
directory. 


Operation is aborted. 


SPECIFIED ROM DOES NOT 
EXIST 


Relocatable Object Module (ROM) does 
not exist within the specified library. 


Operation is aborted. 


REFERENCES TO F4:COM 
NOT ALLOWED 


An external definition or reference 
F4:COM encountered in a Relocat- 
able Object Module (ROM) being 
copied to the library. 


RAD Editor skips to the end of the mod- 
ule. A key-in of C causes Editor to 
read next record from specified device. 


ROM DOES NOT CONTAIN 
A DEF 


Relocatable Object Module (ROM) 
being copied does not contain an 
external definition. 


A key-in of C causes Editor to read 
next record from specified device. 


DUPLICATE DEF xxxxxxxx 


Relocatable Object Module (ROM) 
being copied to the library contains 
duplicate definitions. 


RAD Editor skips to the end of the mod- 
ule. A key-in of C causes Editor to 
read next record from specified device. 


ILLIGAL LOAD ITEM xx 


Relocatable Object Module (ROM) to 
the library contains an illegal load 
item. 


RAD Editor skips to the end of the mod- 
ule. A key-in of C causes Editor to 
read next record from specified device. 


FILE xxxxxxxx WAS NOT 
TRUNCATED. FSIZE=0 


File was not truncated because the 
file size being suggests either a 
direct access file or a file with 
records. 


Editor continues. 


SREC VALUE GREATER THAN 
EREC VALUE 


Parameter error on the :DUMP direc- 
tive. The last record to be dumped 
precedes the initial area to be dumped. 


Operation is aborted. 


AREA xx CONTAINS NO FILES 


Specified area contains no files. 


Editor continues. 


RECORD SIZES DIFFER ON 
INPUT AND OUTPUT FILES 


Record sizes differ on copying from 
RAD file to RAD file. 


Operation is aborted. 


ILLEGAL OPTION xxx 


Option specified is not permitted 
on a :COPY command. 


Operation is aborted. 


Qlirpcn C kA /i \ 1 CD TLjAKI 

uu ii l- i\ jiy w-\i_i_i- i\ i i iniN 

DATA READ 


space. 




NOT ENUF BACKG SPACE 


Insufficient background space to 
perform requested operation. 


Operation is aborted. 
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Table 9. RAD Editor Error and Status Messages (cont.) 



Message 


Meaning 


Action Taken 


UNABLE TO FIND AREA xx 


Specified area cannot - be found on 
RAD SAVE tape during a :RESTORE 
operation. 


Operation is aborted. 


AREA xx INCOMPATIBILITY 


Attempting to restore specified area 
onto a different type of RAD from 
which it was saved, or the area to 
be restored is too large for the same 
area using the current Master 
Directory. 


Operation is aborted. 


AREA xx CKSM ERROR 


A checksum error exists on the RAD 
SAVE tape in the specified area. 


Operation is aborted 


AREA xx TRUNCATED 


Specified area being restored is 
larger than the same area using the 
current Master Directory, but the 
data that was lost contained all zeros. 


Operation continues. 


SAVE TAPE OK 


RAD SAVE tape has been verified 
correctly. 


No action. 


CKSM ERR ON SAVE TAPE 


A checksum error has been encountered 
while verifying the RAD SAVE tape. 


Operation is aborted. 


AREA SPECIFIED IS NOT 
MAINTAINED BY THE RAD 
EDITOR 


An attempt has been made to use area 
CK, XA, or BT which is not maintained 
by the Editor. 


Operation is aborted. 


ILLEGAL USE OF .-COPY 


The specified combination of input 
and output devices on the :COPY 
command is prohibited. 


Operation is aborted. 



Table 10. RAD Restoration Messages 



Message 


Meaning 


Resulting Action 


yyndd WRT PROT 


RAD is write-protected 


Program will attempt the RAD write 
after an SY key-in. 


CKSM ERROR 


A checksum error has occurred in 
reading the SAVE tape 


If WAIT condition is cleared, boot- 
strap loader continues and accepts 
bad record. 


RAD RESTORED OK 


RAD restoration has been success- 
fully completed. 


Control is transferred to the RAD 
bootstrap. 


yyndd ERROR, SB=xxxx 


A parity or transmission error has 
occurred on device yyndd. The 
device status byte (SB=) is also 
displayed. 


There is no recovery. 


yyndd UNUS. END, 
TDV=xxxx 


An unusual end status has been re- 
turned from the specified device. The 
TDV status byte (TDV=) is also displayed. 


There is no recovery on a read operation. 
On a write operation, the write is tried 
again after WAIT is cleared. 
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Table 10. RAD Restoration Messages (cont.) 



Message 


Meaning 


Resulting Action 


TRK=xxxx 
DATA=ALL ZEROS 


Specifies contents of RAD controller 
address register in hexadecimal at 
the time of a check write error. 


If the data being written contains all 
zeros, this information is output. If 
WAIT condition is cleared, bootstrap 
loader continues. 


yyndd UNRECOG., SB=xxxx 


An unrecognized status has been 
returned from the indicated device. 
The device status byte is also 
displayed. 


Upon clearing the WAIT condition, 
operation is retried. 
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7. OVERLAY LOADER OPERATIONS 



The Overlay Loader creates programs for execution in over- 
lay format to reduce core space requirements during execu- 
tion. An overlay program consists of a root and any number 
or segments. 



OPERATOR HANDLING 

Executable versions of programs with overlay segments are 
identical to nonoverlayed programs in terms of operator in- 
tervention. The Loader uses two passes to create the seg- 
mented program. The only listed output from the Overlay 
Loader is a map and possible diagnostic messages. 



ERROR DIAGNOSTICS 



required, the Loader calls the Monitor WAIT function. 
The operator should initiate an INTERRUPT and key in 
one of the following: 

C Continue 

X Abort 

COC Read the corrected command from OC and 

continue (used only in response to control 
command errors). 

Note that the Monitor WAIT routine aborts if an ! ATTEND 
control command has not been encountered in the job 
stack. 



The Overlay Loader outputs diagnostic messages on the OC 
and LL devices. Duplication is suppressed if OC and LL 
are assigned to the same device. If an operator response is 



The diagnostic messages listed in Table 11 are output by 
the Overlay Loader. 



Table 11. Overlay Loader Diagnostics 



Text 


Meaning 


Action 


BACKGROUND TOO SMALL 


User's program cannot be loaded in the 
current size of the background. This is a 
function of the number of external sym- 
bols and forward references that a pro- 
gram has, not a function of the program 
length. 


Abort 


BINARY CARD ENCOUNTERED INSTEAD OF CC 


A binary record instead of a control 
command was encountered on the C 

UC V 1 ^.c 


Wait 


BOT ON f^ ndd 

^area,name 


Unexpected beginning-of-tape has been 
encountered on the specified device/file. 


Abort 


BUF SMALLER THAN DATA RECORD 
DCB x:xxxxxx 


Specified DCB has been assigned to a 
record size larger than the I/O buffer 
associated with the Read request. Either 
user has assigned incorrectly, or Loader 
has a program error. 


Abort 


CC ERR: DUP NAME IN ITEM xx 


Item number xx on the command is a du- 
plicate of a name in the symbol table. 


Wait 


CC ERR: DUP SEG IDENT 


Ident on SEG command is a duplicate of 
a previous segment's ident. 


Wait 


CC ERR: FOLLOWING ITEM xx 


There is an error following item xx on 
the command (e. g. , a parameter has 
been omitted, an extra parameter has 
been included, etc.). 


Abort if OLOAD 
CC. Wait if any 
other CC. 
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Table 11. Overlay Loader Diagnostics (cont.) 



Text 


Meaning 


Action 


CC ERR: ILLEGAL CC SEQUENCE 


Loader commands have been ordered 
incorrectly. 


Wait 


CC ERR: ILLEGAL OPTION FOR PUBLIB LOAD 
(PUBL,name) 


Option (PUBLIB,name) was specified 
on OLOAD and a PUBLIB command 
has been encountered. 


Abort 


CC ERR: ILLEGAL OPTION FOR PUBLIB LOAD 
(TASKS,value) 


Option (TASKS, value) was specified on 
OLOAD and a PUBLIB command has 
been encountered. 


Abort 


CC ERR: ILLEGAL OPTION FOR PUBLIB LOAD 
(TEMP /V alue) 


Option (TEMP,value) was specified on 
OLOAD and a PUBLIB command has 
been encountered. 


Abort 


CC ERR: ILL OPCODE IN ITEM xx 


Specified operation code is either ille- 
gal or unimplemented. 


Wait 


CC ERR: ILL SEG IDENT 


Seg ident on the MODIFY command does 
not match the segment being modified. 


Wait 


CC ERR: ITEM xx 


Item number xx on the command is in error. 


Abort if OLOAD 
CC. Wait if any 
other CC. 


CC ERR: MODIFY OUTSIDE SEG LIMITS 


One of the locations on the MODIFY 
command is outside the limits of the 
segment. 


Wait 


CC ERR: NEED (FORE,fwa,lwa) OPTION FOR PUBLIB 
LOAD 


Option (FORE,fwa,lwa) was not specified 
on the OLOAD command and a PUBLIB 
command has been encountered. 


Abort 


CC ERR: SEG IDENT NOT 1ST OPTION 


Segment ident (LINK,ident^) is not the 
first option on the SEG command. 


Wait 


CC ERR: SEGMENTS ORDERED INCORRECTLY 


SEG commands have been input in the 
wrong order. 


Wait 


CC ERR: SPECIFIED AREA FOR PUBLIB LOAD NOT 'FP' 


Option (FILE,area,name) on OLOAD did 
not specify the Foreground Programs area 
(FP) and a PUBLIB command has been 
encountered. 


Abort 


CC ERR: STEP OPTION ILLEGAL WITHOUT ATTEND 


An ATTEND command must be included 
in the job when the STEP option is 
specified. 


Abort 


CC ERR: UNDEFINED FILE,area,name 


Area and file specified in the option 
(FILE,area,name) has not been defined 
hw j-hg RAD Editor. 


Abort if OLOAD 
CC. Wait if any 
other CC. 


CC ERR: UNDEFINED SYMBOL IN ITEM xx 


Symbol name in item xx on the MODIFY 
command has not been defined. 


Wait 



34 Operator Handling 



Table 11. Overlay Loader Diagnostics (cont.) 



Text 


Meaning 


Action 


DCB CANNOT BE A DSECT 

fULIB' 
SEGxxxxx ROM xxx 
IsLIB. 


A DCB was encountered in the named 
segment that was assembled as a dummy 
section instead of being oart of the 
control section. 


Abort 


DCB HAS BAD PARAMETERS 
DCB x:xxxxxx 


Specified DCB has bad parameters. 
Either user has assigned incorrectly, or 
Overlay Loader has a program error. 


Abort 


DCB HAS INSUFFICIENT INFO 
DCB xrxxxxxx 


Specified DCB contains insufficient in- 
formation to open a Read or Write oper- 
ation. Either user has assigned incor- 
rectly, or Loader has a program error. 


Abort 


DCB NOT ASSIGNED 
DCB x:xxxxxx 


Specified DCB has been assigned to the 
"null" device. Either user has assigned 
incorrectly, or Overlay Loader has a 
program error. 


Abort 


DEFAULT ENTRY ADDRxxxxx SUPPLIED FOR ROOT 


A transfer address was not encountered 
on any ROM in the root and an entry 
address was not specified on the CC; 
therefore, a default has been supplied. 


Continue 


DSECTs in 
SEGxxxxx 


PUBLIB 

'ULIB 1 

ROM 

.SLIB, 


LOAD 
•xxx 


Labeled COMMON blocks (DSECTs) are 
illegal in the Public Libraries. 


Abort 


EOT ON 


/yndd 
area, name 


lku^ui"iuuc iiuj kj^cii ci iv^twfui i ici CV4 ui i IMC 

specified device/file. 


\A/~:«. 

nun 


EXLOC TOO LARGE 
SEGxxxxx 


Specified segment will Qy.cQQdi 131K at 
the given EXLOC. 


Ak rt 


FILE DESTROYED area,name 


Overlay Loader is aborting past the point 
where data has been written on the spec- 
ified program file. The first sector of 
the file has been zeroed out. 


Abort 


FILE UNCHANGED area,name 


Overlay Loader is aborting at a point 
where the program file is unchanged. 


Abort 


ILLEGAL L 
SEGxxxxx 


OAD L 

ULIB' 
ROM 
.SLIB. 


OCATION xxxxx 

XXX 


Specified " load location" origin has been 
defined with a value that is either not an 
address or that lies outside the address 
limits of the specified segment. 


Abort 


ILL SEG IDENT TERMINATED MODIFY'S 


MODIFY commands have been ordered 
incorrectly for the (GO, LINKS) option. 
The MODIFY mode has been terminated 
at this point. If user wishes to continue, 
all MODIFY commands that follow will 
be ignored. 


Wait 
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Table 11. Overlay Loader Diagnostics (cont.) 




Text 


Meaning 


Action 


INITIALIZING LCOM OUTSIDE SEG 
SEGxxxxx 


A labeled COMMON block must be ini- 
tialized in the segment where the block 
is allocated. 


Continue (the la- 
beled COMMON 
block will not be 
initialized). 


LIB ROM'S EXCEED MAX 
SEGxxxxx 


Maximum number of library ROMs that 
can be loaded is 2000. 


Abort 


MONITOR CC ENCOUNTERED INSTEAD OF :ROOT 
or :PUBLIB 


Monitor control command instead of a 
ROOT or PUBLIB command was encoun- 
tered on the C device. 


Abort 


MOUNT PAPER TAPE ROM 


STEP option was specified on OLOAD 
and the next Relocatable Object Module 
(ROM) is to be input from the paper tape 
reader. Operator should load the paper 
tape, interrupt, and key in "C". 


Wait 


PROGRAM 
SEGxxxxx 


ERR: « 

'ULIB 1 
ROM 
.SLIB . 


ccr 

ONE 
TWO 
MAP 

XXX 


►ADDRxxxx 


Loader has a program error in the named 
overlay at the specified address. 


Abort. Operator 
should get a core 
dump. 


PROGRAM ERR: « 
DCB x:xxxxxx 


r ccr 

ONE 
TWO 
MAP 
LIB 


►SB = xx,ADDRxxxx 


Specified error status has been returned 
from an Overlay Loader call (in the 
named overlay) to a Monitor I/O routine. 
The address of the CAL and the name of 
the DCB are specified. 


Abort 


PROGRAM 
SEGxxxxx 


ERR: 

ULIB 1 
ROM 
>SLIB, 


UNALLOCATED CSECT 

XXX 


Loader has encountered a control section 
that has not been allocated; either a 
Loauer, compiler, or assemuier error. 


Abort 


RAD FILE TABLE FULL 


RAD File Table size that was allocated 
at SYSGEN is insufficient. 


Abort 


READING AN OUTPUT DEVICE 
DCB x:xxxxxx 


A DCB that the Overlay Loader reads 
with has been assigned to an OUT de- 
vice. Either user has assigned incor- 
rectly, or Loader has a program error. 


Abort 
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Table 11. Overlay Loader Diagnostics (cont.) 



Text 


Meaning 


Action 


ROM ERR: BAD SEQ 

fULIB] 
SEGxxxxx |rOM| xxx SEQNOxxx 
ISLIB J 


Sequence number of the binary record 
does not equal xxx. 


Wait 


ROM ERR: 
SEGxxxxx 


CHKSl 

ULIB" 
ROM 
.SLIB . 


JM 
xxx SEQNOxxx 


Specified binary record has a checksum 
error. 


Wait 


ROM ERR: 
SEGxxxxx 


EXPRESSION SIZE EXCEEDS MAX 

'ULIB" 

ROM xxx SEQNOxxx 
.SLIB . 


An object language expression on the 
specified binary record exceeds 120 
bytes. 


Abort 


ROM ERR: 
SEGxxxxx 


ILLEG 

'ULIB" 

ROM 

.SLIB . 


^L LOAD ITEM 
xxx SEQNOxxx 


Object language on specified binary 
record cannot be translated (assembler 
or compiler error). 


Abort 


ROM ERR: 
SEGxxxxx 


NO M 

ULIB" 

ROM 

.SLIB . 


ODULE END 
xxx SEQNOxxx 


Module end was not encountered on the 
last binary record of the relocatable 
object module. 


Abort 


ROM ERR: NOT OBJECT LANGUAGE 

fULIB] 
SEGxxxxx | ROM[ xxx SEQNOxxx 
ISLIB J 


Specified binary record is not in object 
language format. 


Wait 


ROM ERR: NOT < 

[ULIB" 

SEGxxxxx j ROM 

ISLIB . 


;tandard bin 

xxx SEQNOxxx 


Specified record has a nonstandard bi- 
nary format. 


Wait 


UNDEFINED FILE are a/ name 
DCB x:xxxxxx 


Specified DCB has been assigned to a 
RAD file that has not been defined by 
the RAD Editor. 


Abort 


UNDEFINED ORIGIN 

fULIBI 
SEGxxxxx j ROM|xxx 
ISLIB J 


Loader has encountered a" load location" 
origin with an expression that cannot be 
resolved. 


Abort 


UNEXPECTED EOD ON jy> ,ndd 

larea,name 


Unexpected !EOD was encountered on 
the specified device/file. 


Wait if the EOD 
was encountered 
instead of a ROM; 
otherwise, Abort. 



Operator Handling 37 



Table 11. Overlay Loader Diagnostics (cont.) 



Text 


Meaning 


Action 


UNEXPECTED MONITOR CC ON (yy ndd 

^area,name 


Unexpected Monitor control command 
was encountered while reading ROMs 
from the C device. 


Abort 


UNRECOVERABLE RD ERR ON jy/ ndd 

larea,name 


Transmission error has occurred while 
reading from the specified device/file. 


Abort 


UNRECOVERABLE WR ERR ON (yy ndd 

(area, name 


Transmission error has occurred while 
writing on the specified device/file. 


Abort 


WARNING 
SEGxxxxx 
DCB x.-xxxx 


DCB IN OVERLAY SEGMENT 

'ULIB1 

ROM J xxx SEQNOxxx 
.SLIB J 

XX 


Specified DCB was declared an external 
DEF in a segment other than the ROOT. 
The DCB will not be included in DCBTAB. 


Continue 


WARNING: DEF'D DCB NOT DEFINED 
DCB x:xxxxxx 


Specified DCB was declared an external 
DEF and the DEF was never defined. 


Continue 


WARNING: DUPLICATE DEF'S 


User's program contains duplicated exter- 
nal DEFs. Map will indicate the name(s) 
of the DEFs. 


Continue 


WARNING: DUPLICATE REF'S 


User's program contains duplicate exter- 
nal REFs. Map will indicate the name(s) 
of the REFs. Occurs when identical DEFs 
in different segments of different paths 
are referenced by the same REF (in a seg- 
ment common to both paths). 


Continue 


WARNING: ENTRY ADDRxxxxx OUTSIDE SEGMENT 
SEGxxxxx 


Entry address for specified segment is 
outside segment's address limits. 


Continue 


WARNING: ILLEGAL DCB ADDR 
DCB x:xxxxxx 


Specified DCB was declared an external 
DEF and the DEF has been defined with 
either a negative address or a constant. 


Continue 


WARNING 
SEGxxxxx 
DCB x:xxxx 


ILLE 

'ULIB' 
ROM 
.SLIB . 

XX 


GAL DCB NAME 
xxx SEQNOxxx 


Specified DCB name is illegal and will 
not be included in DCBTAB. Monitor 
DCBs (M:) must have standard OPLB 
names. User DCBs (F:) must not exceed 
eight EBCDIC characters in length. 


Continue 


WARNING 
THAN 

•JCvjXXXXX 


LCO 
ALLOC 

ULIB" 

KUiVi 

.SLIB . 


M name OF SIZExxxx GREATER 

:ated 

XXX jCVojiN'OXXX 


Named labeled COMMON blocks 
(DSECT) with the size specified (words) 
is greater than the size allocated. 


Continue 


WARNING: NO ENTRY ADDRESS FOR ROOT 


Root does not have an entry address. 


Continue 
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Table 11. Overlay Loader Diagnostics (cont.) 



Text 


Meaning 


Action 


WARNING: OVERLAY SEG GREATER THAN 16K 
SEGxxxxx 


Specified overlay segment exceeds the 
maximum size record that can be loaded 
by the Monitor SEGLOAD function. 


Continue 


WARNING: PROGRAM EXCEEDS SPECIFIED ADDR 
LIMITS 


User's program exceeds address limits, 
either those specified on OLOAD or the 
defaults for background/foreground 
programs. 


Continue 


WARNING: UNDEFINED DEF'S 


User's program contains external DEFs 
that either have not been defined or have 
been defined with an expression the 
Loader cannot resolve. Map will indi- 
cate the name(s) of the undefined DEFs. 


Continue 


WARNING: UNDEFINED ENTRY ADDR 
SEGxxxxx 


Expression defining entry address for 
specified segment cannot be resolved by 
Loader. 


Continue 


WARNING: UNSATISFIED REF'S 


User's program contains unsatisfied exter- 
nal REFs. Map will indicate the name(s) 
of the REFs. 


Continue 


WRITING ON INPUT DEVICE 
DCB x:xxxxxx 


A DCB that the Overlay Loader writes 
with has been assigned to an IN device. 
Either user has assigned incorrectly, or 
Loader has a program error. 


Abort 


yyndd WRITE PROT 


Specified RAD is write-pro tec ted. 


Wait and 

1 . Reset RAD 
protection 
switches, or 

2. Interrupt and 
key-in "SYC", 
or 

3. Interrupt and 
key-in "X" if 
the job is not 
allowed to 
write on pro- 
tected areas 
of the RAD. 



OVERLAY CONTROL COMMANDS 

When the ! OLOAD control command is read by the Job 
Control processor, it causes the Overlay Loader processor 
to be read into the background and executed. All Loader 
subcommands are identified by a leading colon (e.g., 
:SEG). They are read from the C device and logged 
onto LL. Blank cards are passed over without comment. 
When the next Monitor control command is encountered, 
the Loader completes the load process and exits to the 
Monitor. 



!EOD can only be used as a terminator for object module 
input; its use is illegal for terminating the Loader Control 
command stack. 



CONTROL COMMAND SEQUENCE 

The control command stack is divided into major divi- 
sions or substacks, which must occur in the order given 
in Figure 10. 
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In Figure 10, the :COMMON, :LCOMMON, :LIB, 
:INCLUDE, :EXCLUDE, :RES, and :MODIFY commands may 
occur in any :ROOT or :SEG substack and apply only to that 
root or segment. The :ASSIGN commands must follow all 
other commands in the stack. 

ROOT OR SEG SUBSTACK SEQUENCE 

A ROOT or SEG substack has the order given in Figure 11. 

PUBLIB SUBSTACK 

The :PUBLIB substack may be used to replace the :ROOT, 
:SEG, and :ASSIGN substacks within the control command 
stack. In this case, the :PUBLIB substack will have the 
order illustrated in Figure 12. 

LOADER COMMAND FORMATS 

All acceptable Loader commands are given in Table 12 and 
are listed in a logical, but not necessarily typical, operating 



sequence. Sample parameters are given in the "Example" 
column only to illustrate typical parameter formats. An 
explanation of the parameters is not given (a more de- 
tailed description is given in the XDS Sigma 5/7 RBM 
Reference Manual). 



!(Next Monitor Command) 



IASSIGN 



:SEG 



:SEG 



:ROOT 



lOLOAD 



Figure 10. Major Substack Sequence 



rMODIFY 



JBir 



rMODIFY 



Binary Object Module n 




Binary Object Module]* 




May occur in 
any order 



J 



rCOMMON 



:RES 



rLCOMMON 



:LIB 



rEXCLUDE 



INCLUDE 



X 



:ROOT (or :SEG) 



!■„. 



Binary object modules are Included at this point in the substack oniy if the input device specified on the 
preceding ROOT or SEG command is the same as the C device. 



Figure 11. ROOT or SEG Substack Sequence 
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rMODIFY 



:MODIFY 

M 

|Binary Object Module n 



May occur in 
any order 




Binary Object Module] 



: EXCLUDE 




:INCLUDE 



: PUB LIB 



Figure 12. PUBLIB Sequence 
Table 12. Loader Control Commands 



General Form 


Example 


Meaning 


IOLOAD (option JOoption). . . Coption ) 


IOLOAD (MAP, ALL), , 

[ 

1 (FILE,BP,CALCLOAD) 


Calls the Overlay Loader. Any error on 
the command causes Loader to abort. Re- 
covery consists of correcting error and re- 
loading entire job. 


^^ n,- M -rr,w , rs / inpUt \ 

I \ °P hon } ) 1 


:ROOT (ENTRY, IN IT), — , 
' (DEVICE,CRA03) 


Specifies object modules from which root 
segment is to be created. Must precede 
all SEG commands. 


\ "p |iu,, n /_ 




:SEG (LINK,ident 


,ONTO,ident ), , 


:SEG (LINK,1,ONTO,0) 


Defines a segment's overlay linkage and 
specifies object modules from which the 
segment is to be created. 


' (FYI Or nr\AA fFNTRY HoP 




1 1 


1 /input \ /input \ 

^optionj/" * " \option n /_ 




:LIB [(USER, SYSTEM)] 


:LIB (USER) 


Specifies library search for one segment 
only (identified by the preceding ROOT 
or SEG command). Option keywords de- 
note libraries and order of search. If 
neither is specified, library search (ex- 
cept for Public Library) is suppressed for 
that segment. 


[INCLUDE (def |",def . .,def 1) 


:INCLUDE (9CADD, — > 
•— 8EDITT) 


Permits routines to be loaded from li- 
braries when no reference to the routine 
has been made in any module of the 
segment. 
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Table 12. Loader Control Commands (cont.) 



General Form 


Example 


Meaning 


rEXCLUDE (def ] Hdef^ . . .,def 1 ) 


rEXCLUDE (8END10L,-! 
' 6DATLINK) 


Inhibits library search and linkage for the 
named definition(s) even though an ex- 
ternal reference occurs in a module of 
the segment. 


:COMMON 


rCOMMON 


Sets the base of Blank COMMON at end 
of segment identified by the preceding 
ROOT or SEG command. If the command 
is not included, Blank COMMON is set 
at end of the longest path. Only one 
COMMON command can be present in 
the control command stack. Specifica- 
tion field must be blank. 


:RES (def,size). ,(def,size) , . . ., — i 


:RES (RE S A, 200), (X, 147) 


Permits user to reserve and name one or 
more areas at the end of the segment for 
load-time or runtime debug purposes. 
Size is a decimal value. 


' (def,size) 

n J 


:LCOMMON (blockname,size) |, . . . — » 


:LCOMMON (LCOMA, — . 


Permits user to determine allocation of 
labeled COMMON blocks within root 
and overlay segments. 


' ,(blockname, size) 


' — 1200,(QCOM,720) 


:MODIFY [(SEG,ident),] (LOC,address) — . 


:MODIFY (LOC,MAP+. FO)-i 
' ,(BPATCH+6) 


Modifies core locations of relocatable 
programs at load time. MODIFY com- 
mands must be input at the end of the 
ROOT, SEG, or PUBLIB substack for seg- 
ment being modified. 


' — ,word.,... Lword 


:ASSIGN (deb [,area,name]) , 

1 [, (option), (option),. . ., (option)] 


:ASSIGN (MLO,9TA81),VFC 


Creates, initializes,or modifies DCBs at 
load time. Must be last commands in the 
control command stack. 


:PUBLIB [('7M , ( in f ) _. 

1 \option/ yoption/ 


1. :PUBLIB 

2. :PUBLIB (FILE,FP,X), — , 

L-(DEVICE,9TA82,2) / -| 


Specifies the object modules from which 
the Public Library is to be created. Order 
of the parameters determines the order of 
loading. 


1 / in P ut \1 

\option/J 


L (FILE,BJ,GO,EOD) 



OVERLAY LOADER DECK SETUPS 

Examples of typical programs using the Overlay Loader are 
illustrated in Figures 13 and 14. 

In Figure 13, the JOB card rewinds the GO file, the 
FORTRAN source deck is compiled, and the binary object 
module is output on GO. The Macro- Symbol compressed 
source deck is uodated and the binary object module is out- 
put to file CALC2 in the D5 area (previously allocated by 
the RAD Editor). The ROM (Relocatable Object Module) im- 
plied on the :ROOT and designated on the :SEG commands is 
loaded, and the loaded program is output toCALCLOAD in the 



BP area. The :ROOT command causes the ROM created by 
FORTRANH to be loaded from the GO file and creates the 
Root. The ROMs following the first :SEG command are 
loaded until !EOD is encountered and segment 1 is then 
created. The next :SEG command loads the ROM assem- 
bled by Macro-Symbol on the CALC2 file in the 05 area 
and creates segment 2. The !RUN command executes the 
loaded segmented program. 

In Figure 14, the GO file is rewound by the initial !JOB 
command for the first FORTRAN compilation. The Overlay 
Loader loads from the GO file to form a root and outputs on 
the OV file for execution. A map is not output since MAP 
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option is not specified. A postmortem dump is requested if 
the background aborts. The next !JOB command rewinds 
the GO file and three FORTRAN jobs are compiled, with 
the binary object modules output on GO to form ROM!, 
ROM2, ROM3 (Relocatable Object Modules). The Overlay 



Loader loads the first ROM for the root, the second ROM 
for segment 1, and the third ROM for segment 2. Note 
that :SEG cards are not required. The programs are exe- 
cuted from the OV file. A postmortem dump is speci- 
fied in case an abort occurs. 



!FIN 



!RUN BP,CALCLOAD 



:(FILE, D5,(CALC2)) 



:SEG (LINK, 2, ONTO, 0) 



!EOD 

/mm. 



Binary Object Module 



Binary Object Module 



M 



Binary Object Module 




:(DEVICE, CRA03,EOD) 



:SEG (LINK, 1, ONTO, 0); 



:ROOT 



:(FILE,BP,CALCLOAD) 



SOLOAD (MAP, ALL); 



Compressed Deck 




f 



M 



Update Deck 




IMACRSYM CI, SI, CO, LO, BO 



! ASSIGN (M:BO,D5,CALC2) 



Source Deck 




IFORTRANH SI, GO, LO, LS 



! ATTEND 



UOB 



J 



Figure 13. Overlay Loader Segmented Job Example 
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IFIN 



IROV 



1PMD 

!OLOAD (GO, LINKS) 



FORTRAN Source Deck 




IFORTRANH SI, GO, LO, LS 



M 



FORTRAN Source Deck 




IFORTRANH SI, GO, LO, LS 



FORTRAN Source Deck 




IFORTRANH SI, GO, LO, LS 



!JOB 



!ROV 



!PMD 



:VFC, (RECL, 133) 



! ASSIGN (F:2, LPA02),BCD; 



-A 



IOLOAD GO, (UDCB, 1) 



FORTRAN Source Deck 



IFORTRANH SI, GO, LO, LS 



IATTEND 



\ 



!JOB 




Figure 14. Overlay Loader Batch Example with GOLINKS 
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